Référence

Schéma marketplace.json

Le manifeste de la place de marché se trouve dans .claude-plugin/marketplace.json à la racine du dépôt.

Champs de niveau supérieur

Champ	Requis	Description
`$schema`	Non	URL du schéma JSON pour la validation
`name`	Oui	Identifiant unique de la place de marché
`version`	Non	Version du schéma de la place de marché (semver)
`metadata.description`	Oui	Description lisible de la place de marché
`owner.name`	Oui	Organisation ou utilisateur propriétaire de la place de marché
`owner.url`	Non	URL vers le profil ou le site web du propriétaire
`owner.email`	Non	Adresse e-mail de contact
`plugins`	Oui	Tableau des entrées de plugins

Champs d’une entrée de plugin

Champ	Requis	Description
`name`	Oui	Identifiant du plugin (doit correspondre à `plugin.json`)
`description`	Oui	Description courte du plugin
`version`	Oui	Chaîne de version sémantique
`author.name`	Oui	Auteur du plugin
`source`	Oui	Chemin ou URL vers le plugin (voir Types de sources)
`category`	Oui	Catégorie du plugin (ex. : `productivity`)
`homepage`	Non	URL vers la documentation ou la page d’accueil du plugin
`license`	Non	Identifiant de licence SPDX
`keywords`	Non	Tableau de mots-clés de recherche
`tags`	Non	Tableau de tags pour le filtrage
`repository`	Non	URL du dépôt

Types de sources de plugins

Le champ source dans marketplace.json prend en charge plusieurs formats :

Type	Exemple	Description
Chemin relatif	`./plugins/example-plugin`	Plugin dans le même dépôt
Raccourci GitHub	`owner/repo`	Plugin à la racine du dépôt
GitHub avec chemin	`owner/repo/path/to/plugin`	Plugin dans un sous-répertoire
URL Git	`https://github.com/owner/repo.git`	Dépôt Git
Paquet npm	`npm:@scope/package`	Paquet npm publié

Schéma plugin.json

Chaque plugin possède un manifeste situé dans .claude-plugin/plugin.json à l’intérieur de son répertoire.

Champ	Requis	Description
`name`	Oui	Identifiant du plugin
`description`	Oui	Ce que fait le plugin
`version`	Oui	Version sémantique
`author.name`	Oui	Auteur du plugin
`author.url`	Non	URL vers le profil ou le site web de l’auteur
`homepage`	Non	URL de la documentation
`keywords`	Non	Mots-clés de recherche
`license`	Non	Identifiant de licence SPDX
`repository`	Non	URL du dépôt

Structure du répertoire d’un plugin

plugins/example-plugin/
  .claude-plugin/
    plugin.json          # Manifeste du plugin (requis)
  skills/
    skill-name/
      SKILL.md           # Définition de la compétence (requis par compétence)
      references/        # Fichiers de données de référence (optionnel)
  commands/
    command-name.md      # Définition de la commande (une par commande)
  agents/
    agent-name.md        # Définition de l'agent (une par agent)
  README.md              # Documentation du plugin (recommandé)

Variables d’environnement

Les plugins peuvent utiliser ces variables dans leurs fichiers de compétences et de commandes :

Variable	Description
`$\{CLAUDE_PLUGIN_ROOT\}`	Chemin absolu vers le répertoire racine du plugin

Validation

Validez localement vos manifestes de place de marché et de plugin :

claude plugin validate .

Cette commande vérifie :

La conformité du schéma marketplace.json
L’existence de tous les répertoires de plugins référencés
La présence d’un plugin.json valide pour chaque plugin
Le format correct du frontmatter SKILL.md pour les compétences
La présence des champs de frontmatter requis pour les commandes

Configuration d’équipe

Préconfiguration des places de marché

Ajoutez dans .claude/settings.json dans n’importe quel dépôt :

{
  "extraKnownMarketplaces": [
    "f5-sales-demo/marketplace"
  ]
}

Préactivation des plugins

{
  "enabledPlugins": [
    "f5xc-docs-tools@f5-sales-demo-marketplace"
  ]
}

Résolution des problèmes

Place de marché introuvable

Vérifiez que la place de marché a bien été ajoutée :

/plugin marketplace list

Si elle est absente, ajoutez-la à nouveau :

/plugin marketplace add f5-sales-demo/marketplace

Plugin non activé

Confirmez que le plugin est installé : /plugin list
Vérifiez que votre version de Claude Code prend en charge les plugins (v1.0.33+)
Vérifiez que les conditions de déclenchement de la compétence correspondent à votre contexte actuel

Compétences ne se déclenchant pas automatiquement

Les compétences s’activent en fonction de leur champ description dans le frontmatter de SKILL.md. Si une compétence ne s’active pas comme prévu :

Vérifiez que la description décrit précisément le contexte de déclenchement
Utilisez la commande directement (ex. : /f5xc-docs-tools:review-mdx) comme solution de contournement

Erreurs de compilation après la révision

Le plugin signale les problèmes mais ne les corrige pas automatiquement. Appliquez les corrections suggérées manuellement, puis relancez la révision pour confirmer la résolution.