Un plugin pour une petite équipe

1Faire l'inventaire, à plusieurs

Trente minutes, tout le monde autour de la table. Une seule question : qu'est-ce que tu redemandes au modèle chaque semaine, et sous quelle forme ?

Note les réponses telles qu'elles sortent, sans les reformuler. Tu obtiendras une liste hétérogène : « la revue avant merge », « le message de commit », « le compte rendu de réunion client », « le résumé de ce qui a bougé cette semaine ».

Regroupe ensuite. Ce qui revient trois fois entre dans le plugin. Ce qui revient une fois reste chez la personne qui l'a formulé.

2Poser la structure

Un seul fichier va dans .claude-plugin/, tout le reste est à la racine du plugin.

outils-equipe/
├── .claude-plugin/
│   └── plugin.json
├── skills/
│   ├── revue-avant-merge/SKILL.md
│   ├── compte-rendu-client/SKILL.md
│   └── message-de-commit/SKILL.md
├── agents/
│   └── relecteur.md
└── hooks/
    └── hooks.json

Le manifeste :

{
  "name": "outils-equipe",
  "description": "Les gestes partages de l'equipe : revue, comptes rendus, commits.",
  "version": "1.0.0",
  "author": { "name": "Nom de l'equipe" }
}

Le name sert d'espace de noms : les Skills s'appellent /outils-equipe:revue-avant-merge. C'est verbeux, et c'est voulu : ça évite les collisions et ça rend visible d'où vient ce qu'on invoque.

3Écrire les Skills pour quelqu'un d'autre

C'est la vraie difficulté du passage du personnel au partagé. Une Skill écrite pour soi suppose un contexte que les autres n'ont pas.

---
description: Prepare un compte rendu de reunion client au format de l'equipe. A utiliser apres une reunion client, a partir de notes brutes ou d'une transcription.
---

Produis un compte rendu au format suivant, dans cet ordre :

1. Decisions prises. Une ligne chacune, au passe. S'il n'y en a pas,
   ecris "Aucune decision actee".
2. Points ouverts. Une ligne chacun, avec la personne qui doit trancher.
3. Actions. Une ligne chacune : quoi, qui, pour quand. Si l'echeance
   n'a pas ete dite, ecris "date a confirmer" et ne l'invente pas.
4. Ce qui n'a pas ete aborde alors que c'etait a l'ordre du jour.

Contraintes : pas d'introduction, pas de conclusion, pas de reformulation
des echanges. Si une information manque pour remplir une section, dis-le
plutot que de combler.

Deux détails comptent. La description dit quand utiliser la Skill, pas seulement ce qu'elle fait : c'est ce qui permet au modèle de la déclencher au bon moment. Et la section 4 encode une exigence de l'équipe que personne n'aurait pensé à demander, ce qui est précisément l'intérêt de figer la pratique.

4Ajouter un hook, un seul

Une règle qui doit tenir à 100 % ne doit pas être une consigne. Le plugin porte ses propres hooks dans hooks/hooks.json, avec le même format que dans settings.json.

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Write|Edit",
        "hooks": [
          {
            "type": "command",
            "command": "jq -r '.tool_input.file_path' | xargs -r npx prettier --write"
          }
        ]
      }
    ]
  }
}

Un hook lent s'exécute dans la boucle et se sent à chaque action. Sur un plugin partagé, cette latence est payée par toute l'équipe. Un seul hook utile vaut mieux que quatre qui alourdissent chaque écriture.

5Tester avant de diffuser

Charge le plugin pour une session, sans rien installer :

claude --plugin-dir ./outils-equipe

Puis, dans Claude Code, appelle une Skill par son nom complet, vérifie que les agents apparaissent dans /context, et provoque l'événement du hook pour voir son effet. Après une modification, /reload-plugins recharge sans relancer.

Enfin, passe la validation officielle :

claude plugin validate ./outils-equipe

Elle sort ✔ Validation passed, avec éventuellement des avertissements qui ne bloquent pas. --strict les traite comme des erreurs.

6Distribuer en interne

Pour une petite structure, le plus simple est un dépôt Git privé qui sert de place de marché interne, avec un .claude-plugin/marketplace.json à sa racine. Chacun ajoute la place de marché une fois, puis installe le plugin.

claude plugin marketplace add votre-org/outils-claude
claude plugin install outils-equipe@outils-claude

Le version du manifeste devient alors utile : tant que tu ne l'incrémentes pas, personne ne reçoit tes modifications en cours. Tu peux travailler sur la branche principale sans perturber l'équipe, et publier quand c'est prêt.