# Skills, plugins, extensions : enrichir son agent de code

> Écrire une skill, installer un plugin dans Claude Code ou Codex, une extension dans Gemini CLI : à quoi sert chaque brique, où la ranger, et ce qu'elle coûte.

- Niveau : Expert
- Thème : Plugins, MCP et skills
- Durée : 18 minutes
- Systèmes : Mac, Windows, Linux
- Publié le 17 novembre 2026, relu le 17 novembre 2026
- Auteur : Ulrich Rozier
- Page : https://quelleia.com/guides/skills-et-plugins/

Vous retapez pour la troisième fois la même consigne à rallonge : « relis le diff, cherche les fuites de clés, liste les problèmes par fichier, ne corrige rien sans mon accord ». Ce paragraphe a sa place dans une skill. Et quand vous voulez partager dix skills, deux serveurs MCP et quelques règles automatiques avec votre équipe, vous en faites un plugin.

## À quoi ça sert

- **Une relecture toujours faite de la même façon** avant chaque enregistrement dans Git.
- **Un déploiement en étapes** que l'agent ne doit jamais sauter : tests, construction, vérification, mise en ligne.
- **Un format maison** : le compte rendu de réunion de votre équipe, la fiche produit de votre site, le message de commit attendu.
- **Partager un outillage complet** avec une équipe : un plugin installe d'un coup les skills, les serveurs MCP et les règles automatiques du projet.

## Cinq briques à ne pas confondre

| Brique | Ce qu'elle apporte | Quand elle se charge |
| --- | --- | --- |
| Fichier de consignes (CLAUDE.md, AGENTS.md) | Ce que l'agent doit savoir du projet | À chaque session, en entier |
| Skill | Une procédure : relire, déployer, rédiger un compte rendu | Sur demande, ou quand la tâche correspond à sa description |
| Serveur MCP | Des outils extérieurs : un service, une base, des fichiers | Au démarrage, tant qu'il est branché |
| Hook | Une commande lancée à un moment précis, par exemple après chaque modification | À chaque événement visé |
| Sous-agent | Un assistant spécialisé avec son propre contexte et ses outils | Quand l'agent principal lui délègue une tâche |

Un **plugin** n'est pas une sixième brique : c'est un paquet qui regroupe plusieurs des précédentes pour les installer d'un coup. Gemini CLI parle d'**extensions** pour la même idée.

## Comment ça marche

![Un plugin regroupe des skills, des sous-agents, des hooks et des serveurs MCP. Une skill se charge en trois temps, ce qui permet d'en installer beaucoup sans encombrer l'agent.](https://quelleia.com/guides/skills-et-plugins/plugin-et-chargement-des-skills.svg)

*Un plugin regroupe des skills, des sous-agents, des hooks et des serveurs MCP. Une skill se charge en trois temps, ce qui permet d'en installer beaucoup sans encombrer l'agent.*

### La skill : un dossier et un fichier

Le format est devenu un standard ouvert, Agent Skills, conçu à l'origine par Anthropic. Une skill est un dossier qui contient un fichier `SKILL.md` : un en-tête avec au moins un nom (`name`) et une description (`description`), puis les instructions en Markdown. Le dossier peut aussi contenir des scripts, de la documentation de référence et des modèles de fichiers.

```text
relecture/
├── SKILL.md
├── scripts/
└── references/
```

L'agent charge les skills par étapes. Au démarrage, il ne lit que le nom et la description de chacune. Quand une tâche correspond à une description, il lit tout le `SKILL.md`. Il n'ouvre les scripts et les fichiers annexes qu'au moment de s'en servir. Vous pouvez donc en installer beaucoup sans saturer la mémoire de travail du modèle.

La description décide de tout : c'est elle que l'agent compare à votre demande. Dites ce que fait la skill et quand s'en servir, et, comme le conseille OpenAI, quand ne pas s'en servir.

```markdown
---
name: relecture
description: Relit le diff en cours et liste les problèmes par fichier. À utiliser quand on demande une relecture ou avant un commit. Ne corrige rien.
---

Relis le diff courant contre la branche de base.
Cherche les bogues, les régressions, les clés ou mots de passe en clair
et les requêtes non échappées.
Liste les problèmes par fichier:ligne, du plus grave au moins grave,
avec la raison de chacun. Ne modifie aucun fichier sans mon accord.
```

## Où ranger une skill

**Claude Code.** `.claude/skills/<nom>/SKILL.md` pour le projet (à enregistrer dans Git pour l'équipe), `~/.claude/skills/<nom>/SKILL.md` pour tous vos projets. Le nom du dossier devient une commande : `/relecture`. Claude la charge aussi seul quand votre demande correspond. Dans l'en-tête, `disable-model-invocation: true` réserve la skill à l'appel manuel, utile pour un déploiement. Les anciennes commandes de `.claude/commands/` marchent toujours et ont été fusionnées dans les skills.

**Codex.** `.agents/skills/` dans le projet (Codex remonte jusqu'à la racine du dépôt) et `~/.agents/skills/` pour vos skills personnelles. On les appelle en tapant `$` suivi du nom, ou depuis `/skills`. Deux skills sont livrées avec Codex : `$skill-creator` écrit une skill à partir de votre description, `$skill-installer` en ajoute depuis une sélection.

**Mistral Vibe** et **Gemini CLI** acceptent aussi des skills : Vibe les présente dans sa documentation de la ligne de commande, Gemini CLI les livre dans ses extensions.

## Créer votre première skill étape par étape

Avec Claude Code, sur l'exemple de la relecture :

1. À la racine du projet, créez le dossier de la skill :

```bash
mkdir -p .claude/skills/relecture
```

2. Créez dans ce dossier un fichier `SKILL.md` avec l'en-tête et les instructions de l'exemple ci-dessus.
3. Ouvrez une nouvelle session (`claude`) et tapez `/relecture`. La skill se déroule.
4. Demandez aussi « relis mes changements » sans nommer la skill : Claude doit la choisir seul grâce à sa description. S'il ne le fait pas, précisez la description.
5. Enregistrez le dossier dans Git pour que l'équipe en profite.

Pour Codex, le même dossier se range dans `.agents/skills/relecture/`, et l'appel devient `$relecture`. Le `name` et la `description` sont obligatoires dans l'en-tête.

Ne créez pas une skill par anticipation. Attendez d'avoir tapé deux fois la même consigne, puis affinez-la à l'usage.

## Le plugin : un paquet à installer

Dans **Claude Code**, un plugin est un dossier avec un manifeste `.claude-plugin/plugin.json` et ses composants : skills, sous-agents, hooks, serveurs MCP. Ses skills prennent le nom du plugin en préfixe, par exemple `/mon-plugin:relecture`. Les plugins s'installent depuis une place de marché, un catalogue qui dit où trouver chaque plugin. Claude Code ajoute celle d'Anthropic, `claude-plugins-official`, au premier lancement dans le terminal.

1. Tapez `/plugin` dans une session et ouvrez l'onglet **Discover**.
2. Choisissez un plugin. Pour ceux de la place de marché officielle, l'onglet indique une estimation de son coût en contexte.
3. Choisissez la portée : vous seul dans tous vos projets (utilisateur), toute l'équipe sur ce dépôt (projet), ou vous seul sur ce dépôt (local).
4. Pour couper un plugin sans le désinstaller, passez par `/plugin` ou `claude plugin disable`.

Dans **Codex**, `/plugins` ouvre le navigateur de plugins, rangé par place de marché. En ligne de commande, `codex plugin` ajoute, liste ou retire un plugin et gère les places de marché.

![Terminal : codex plugin --help affiche Manage Codex plugins et les sous-commandes add, list, marketplace et remove, avec leur description.](https://quelleia.com/guides/skills-et-plugins/codex-plugin-aide.webp)

*Sortie réelle de Codex 0.166.0, relevée le 17 novembre 2026 sur le mini-PC de QUELLE IA : les plugins se gèrent aussi en ligne de commande.*

Un plugin Codex peut contenir des skills, des serveurs MCP, des extensions de navigateur et des hooks. Après l'installation, ouvrez une nouvelle session pour que ses skills et ses outils apparaissent.

Dans **Gemini CLI**, une extension regroupe des prompts, des serveurs MCP, des commandes, des thèmes, des hooks, des sous-agents et des skills. Elle s'installe depuis son dépôt GitHub :

```bash
gemini extensions install https://github.com/gemini-cli-extensions/workspace
```

Google a remplacé Gemini CLI par Antigravity CLI pour le grand public le 18 juin 2026. Les extensions y deviennent des « plugins Antigravity ».

## Ce qu'un plugin coûte

Un plugin activé pèse sur chaque session, même quand vous ne vous en servez pas. Pour chaque skill, sous-agent ou commande que l'agent peut appeler seul, le nom et la description restent dans le contexte à chaque échange, ce qui consomme des jetons et réduit la place pour votre travail. Ses serveurs MCP tournent à côté de la session et ses hooks se déclenchent à chaque événement visé.

Faites le ménage de temps en temps. Dans Claude Code, l'onglet **Installed** de `/plugin` regroupe les plugins « Not used recently » que vous pouvez couper.

## La sécurité

Un plugin s'exécute avec vos droits d'utilisateur, quelle que soit la place de marché d'où il vient. Anthropic distingue ses places de marché officielles, celles de sa communauté et toutes les autres, dites tierces, et rappelle que les trois peuvent lancer du code sur votre machine. OpenAI demande de relire les hooks d'un plugin avant qu'ils ne tournent.

1. Lisez le contenu d'un plugin avant de l'installer : ses hooks, ses scripts, les commandes de ses serveurs MCP.
2. Préférez la portée la plus étroite. Un plugin à l'essai s'installe en local, sur un seul dépôt.
3. Une skill qui exécute des commandes a le même pouvoir qu'une commande tapée à la main. Pour un déploiement ou un effacement, gardez l'appel manuel et la demande d'accord.
4. Limitez les outils de vos sous-agents. Dans Claude Code, le champ `tools` de leur en-tête est une liste blanche : un sous-agent de recherche réglé sur `Read, Grep, Glob` ne peut rien modifier.

## Pour aller plus loin

- [Outils de code et agents](https://quelleia.com/outils/)
- [Claude Code](https://quelleia.com/outils/claude-code/)
- [Codex](https://quelleia.com/outils/codex/)
- [Gemini CLI](https://quelleia.com/outils/gemini-cli/)
- [Mistral Vibe](https://quelleia.com/outils/mistral-vibe/)
- [MCP : brancher des outils dans Claude, ChatGPT ou un agent](https://quelleia.com/guides/mcp.md) (guide, amateur)
- [Faire travailler plusieurs agents ensemble, sans casse](https://quelleia.com/guides/plusieurs-agents.md) (guide, nerd)
- [Harnais : pourquoi un même modèle change d'un outil à l'autre](https://quelleia.com/guides/harnais.md) (guide, amateur)
- [Sur mini lab AI](https://minilabai.com/guides/les-skills/) : un guide du même auteur, qui va plus loin

## Sources

- https://agentskills.io/ (lue le 17 novembre 2026)
- https://code.claude.com/docs/en/skills (lue le 17 novembre 2026)
- https://code.claude.com/docs/en/plugins (lue le 17 novembre 2026)
- https://code.claude.com/docs/en/sub-agents (lue le 17 novembre 2026)
- https://learn.chatgpt.com/docs/build-skills (lue le 17 novembre 2026)
- https://learn.chatgpt.com/docs/plugins (lue le 17 novembre 2026)
- https://geminicli.com/docs/extensions.md (lue le 17 novembre 2026)
- https://developers.googleblog.com/an-important-update-transitioning-gemini-cli-to-antigravity-cli (lue le 17 novembre 2026)
