Créer des skills

Utilisez les skills d’agent pour étendre Codex avec des capacités propres à certaines tâches. Un skill regroupe des instructions, des ressources et, éventuellement, des scripts afin que Codex puisse suivre un workflow de manière fiable. Les skills reposent sur le standard ouvert des skills d’agent.

Les skills constituent le format de création des workflows réutilisables. Les plugins distribuent des skills et connecteurs réutilisables à ChatGPT Work sur le web, ainsi qu’à ChatGPT Work et Codex dans l’application de bureau. Codex CLI peut également installer des plugins. Utilisez les skills pour concevoir le workflow lui-même, puis empaquetez-le sous forme de plugin lorsque vous souhaitez que d’autres personnes de votre espace de travail puissent l’installer.

Les skills sont disponibles dans l’application de bureau ChatGPT, Codex CLI et l’extension IDE.

Dans l’application de bureau ChatGPT, ouvrez Skills dans la barre latérale pour afficher et explorer les skills créés dans vos différents projets.

Les skills utilisent la divulgation progressive pour gérer efficacement le contexte : Codex commence par le nom, la description et le chemin de fichier de chaque skill. Codex ne charge l’intégralité des instructions SKILL.md que lorsqu’il décide d’utiliser un skill.

Codex inclut dans le contexte une liste initiale des skills disponibles afin de pouvoir choisir celui qui convient à une tâche. Pour éviter que cette liste n’occupe une trop grande partie du prompt, elle utilise au maximum 2 % de la fenêtre de contexte du modèle, ou 8 000 caractères lorsque la taille de la fenêtre de contexte est inconnue. Si de nombreux skills sont installés, Codex commence par raccourcir leur description. Pour les grands ensembles de skills, Codex peut omettre certains skills de la liste initiale et afficher un avertissement.

Ce budget s’applique uniquement à la liste initiale des skills. Lorsque Codex sélectionne un skill, il lit toujours l’intégralité des instructions SKILL.md de ce skill.

Un skill est un répertoire contenant un fichier SKILL.md, ainsi que des scripts et références facultatifs. Le fichier SKILL.md doit inclure name et description.

my-skill/
├── SKILL.md          # Required: instructions and metadata
├── scripts/          # Optional: executable code
├── references/       # Optional: documentation
├── assets/           # Optional: templates and resources
└── agents/
    └── openai.yaml   # Optional: appearance and dependency declarations

Comment Codex utilise les skills

Codex peut activer les skills de deux manières :

1. Invocation explicite : incluez directement le skill dans votre prompt. Dans la CLI ou l’IDE, exécutez /skills ou saisissez $ pour mentionner un skill.
2. Invocation implicite : Codex peut choisir un skill lorsque votre tâche correspond au champ description du skill.

Comme la correspondance implicite dépend de description, rédigez des descriptions concises dont le périmètre et les limites sont clairement définis. Placez le principal cas d’utilisation et les mots déclencheurs au début afin que Codex puisse toujours trouver le skill si les descriptions sont raccourcies.

Créer un skill

Si vous connaissez déjà le workflow et qu’il est plus facile à montrer qu’à décrire, utilisez Enregistrer et rejouer. Codex enregistre le workflow, examine les étapes et crée une ébauche de skill réutilisable à partir de la démonstration.

Si vous préférez décrire le skill, utilisez le créateur intégré :

$skill-creator

Le créateur vous demande ce que fait le skill, dans quelles circonstances il doit se déclencher et s’il doit se limiter à des instructions ou inclure des scripts. Par défaut, il contient uniquement des instructions.

Vous pouvez également créer manuellement un skill en créant un dossier contenant un fichier SKILL.md :

---
name: skill-name
description: Explain exactly when this skill should and should not trigger.
---

Skill instructions for Codex to follow.

Codex détecte automatiquement les modifications apportées aux skills. Si une mise à jour n’apparaît pas, redémarrez Codex.

Où enregistrer les skills

Codex lit les skills depuis les emplacements du dépôt, de l’utilisateur, de l’administrateur et du système. Pour les dépôts, Codex recherche .agents/skills dans chaque répertoire, depuis votre répertoire de travail actuel jusqu’à la racine du dépôt. Si deux skills partagent le même name, Codex ne les fusionne pas ; ils peuvent tous les deux apparaître dans les sélecteurs de skills.

Codex prend en charge les dossiers de skills liés symboliquement et suit la cible du lien symbolique lors de l’analyse de ces emplacements.

Ces emplacements servent à la création et à la découverte locale. Lorsque vous souhaitez distribuer des skills réutilisables au-delà d’un seul dépôt ou, éventuellement, les regrouper avec des connecteurs, utilisez des plugins.

Distribuer des skills avec des plugins

Les dossiers de skills directs sont particulièrement adaptés à la création locale et aux workflows propres à un dépôt. Si vous souhaitez distribuer un skill réutilisable, regrouper au moins deux skills ou fournir un skill avec un connecteur, empaquetez-les sous forme de plugin.

Les plugins peuvent inclure un ou plusieurs skills. Ils peuvent aussi, de manière facultative, regrouper les correspondances d’applications, la configuration des serveurs MCP et les ressources de présentation dans un même paquet.

Installer des skills sélectionnés pour une utilisation locale

Pour ajouter à votre installation Codex locale des skills sélectionnés en plus de ceux qui sont intégrés, utilisez $skill-installer. Par exemple, pour installer le skill $linear :

$skill-installer linear

Vous pouvez également demander au programme d’installation de télécharger des skills depuis d’autres dépôts. Codex détecte automatiquement les nouveaux skills installés ; si l’un d’eux n’apparaît pas, redémarrez Codex.

Utilisez cette méthode pour la configuration locale et les expérimentations. Pour distribuer vos propres skills de manière réutilisable, privilégiez les plugins.

Activer ou désactiver des skills

Utilisez les entrées [[skills.config]] dans ~/.codex/config.toml pour désactiver un skill sans le supprimer :

[[skills.config]]
path = "/path/to/skill/SKILL.md"
enabled = false

Redémarrez Codex après avoir modifié ~/.codex/config.toml.

Métadonnées facultatives

Ajoutez agents/openai.yaml pour configurer les métadonnées de l’interface dans l’application de bureau ChatGPT, définir la stratégie d’invocation et déclarer les dépendances d’outils afin d’offrir une expérience d’utilisation du skill plus fluide.

interface:
  display_name: "Optional user-facing name"
  short_description: "Optional user-facing description"
  icon_small: "./assets/small-logo.svg"
  icon_large: "./assets/large-logo.png"
  brand_color: "#3B82F6"
  default_prompt: "Optional surrounding prompt to use the skill with"

policy:
  allow_implicit_invocation: false

dependencies:
  tools:
    - type: "mcp"
      value: "openaiDeveloperDocs"
      description: "OpenAI Docs MCP server"
      transport: "streamable_http"
      url: "https://developers.openai.com/mcp"

allow_implicit_invocation (valeur par défaut : true) : lorsque la valeur est false, Codex n’invoque pas implicitement le skill en fonction du prompt de l’utilisateur ; l’invocation explicite $skill reste disponible.

Bonnes pratiques

• Limitez chaque skill à une seule tâche.
• Préférez les instructions aux scripts, sauf si vous avez besoin d’un comportement déterministe ou d’outils externes.
• Rédigez des étapes à l’impératif avec des entrées et des sorties explicites.
• Testez des prompts par rapport à la description du skill pour confirmer que son déclenchement est correct.

Pour plus d’exemples, consultez Réparation de la CI GitHub, PDF, Linear, openai/skills et la spécification des skills d’agent. Pour une distribution installable, privilégiez les plugins.