Créer des skills

Utilisez les skills d’agent pour donner à ChatGPT et à Codex les capacités nécessaires à des tâches précises. Un skill regroupe des instructions, des ressources et, si nécessaire, des scripts qui permettent à chacun des deux produits de suivre un workflow de manière fiable. Les skills s’appuient sur le standard ouvert des skills d’agent.

Les skills sont le format de création de workflows réutilisables. Les plugins permettent de distribuer des skills réutilisables et des connecteurs via le répertoire universel de plugins commun à ChatGPT et à Codex. Ils fonctionnent dans les modes Chat et Work de ChatGPT sur le Web, sur ordinateur et sur mobile, ainsi que dans Codex via l’application de bureau ChatGPT ou Codex CLI. Concevez votre workflow sous forme de skill, puis intégrez-le à un plugin pour que d’autres personnes puissent l’installer.

Les skills autonomes sont disponibles dans l’application de bureau ChatGPT, dans Codex CLI et dans l’extension pour IDE. Les skills intégrés à des plugins sont également disponibles dans les modes Chat et Work de ChatGPT sur le Web, sur ordinateur et sur mobile.

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

Atlas Control (macOS)Use the bundled CLI to control Atlas and inspect local browser data.Personal

Exec PlanCreate, maintain, and execute long-form execution plans ("ExecPlans") for complex work.Personal

GitHub Fix CIDebug failing GitHub Actions CIPersonal

LinearManage Linear issues in CodexPersonal

OpenAI DocsReference the official OpenAI Developer docsPersonal

YeetStage, commit, and open PRPersonal

Skill CreatorCreate or update a skillSystem

Skill InstallerInstall curated skills from openai/skills or other reposSystem

$

6 SolMedium

Les skills utilisent un mécanisme de chargement progressif pour gérer efficacement le contexte. ChatGPT et Codex commencent par lire le nom et la description de chaque skill. Lorsqu’ils décident d’utiliser un skill, ils chargent toutes les instructions de son fichier SKILL.md.

Dans Codex, la liste initiale contient aussi le chemin de chaque skill. Par défaut, cette liste occupe au maximum 2 % de la fenêtre de contexte du modèle. Si la taille de cette fenêtre est inconnue, la limite est de 8 000 caractères. Si de nombreux skills sont installés, Codex commence par raccourcir leurs descriptions. Si leur nombre est très élevé, Codex peut omettre certains skills de la liste initiale et afficher un avertissement.

Utilisez skills.max_context_tokens pour fixer une autre limite, jusqu’à 10 000 tokens.

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

Un skill est un dossier qui contient un fichier SKILL.md et, si nécessaire, des scripts et des documents de référence. Le fichier SKILL.md doit contenir les champs name et description.

Comment ChatGPT et Codex utilisent les skills

ChatGPT et Codex peuvent activer un skill de deux façons :

1. Invocation explicite : mentionnez directement le skill dans votre prompt. Dans ChatGPT, saisissez @ pour sélectionner un skill. Dans Codex CLI ou dans l’extension pour IDE, exécutez /skills ou saisissez $ pour mentionner un skill.
2. Invocation implicite : ChatGPT ou Codex peut choisir un skill lorsque votre tâche correspond à son champ description.

Comme la sélection implicite repose sur le champ description, rédigez des descriptions concises qui précisent dans quels cas le skill s’applique et quelles en sont les limites. Placez le principal cas d’utilisation et les mots déclencheurs en début de description. L’hôte pourra ainsi identifier le skill approprié même si la description est raccourcie.

Créer un skill

Si vous connaissez déjà le workflow et qu’il est plus facile de le montrer que de le décrire, utilisez la fonction Enregistrement et relecture. L’enregistreur capture le workflow, en examine les étapes et crée une première version d’un skill réutilisable à partir de votre démonstration.

Si vous préférez décrire le skill, utilisez l’outil de création intégré. Dans ChatGPT Work, invoquez-le avec @skill-creator. Dans Codex, invoquez-le ainsi :

$skill-creator

L’outil vous demande à quoi sert le skill, dans quels cas il doit se déclencher et s’il doit se limiter à des instructions ou inclure des scripts. Par défaut, le skill contient uniquement des instructions.

Vous pouvez aussi créer un skill manuellement. Créez un dossier contenant un fichier SKILL.md :

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

Skill instructions for ChatGPT or 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ù Codex charge les skills locaux

Codex lit les skills aux emplacements prévus pour le dépôt, l’utilisateur, l’administrateur et le système. Dans un dépôt, Codex recherche le dossier .agents/skills dans votre répertoire de travail actuel, puis dans chaque répertoire parent jusqu’à la racine du dépôt. Si deux skills ont le même name, Codex les conserve séparément. Tous deux peuvent apparaître dans les sélecteurs de skills.

Codex prend en charge les liens symboliques vers des dossiers de skills. Il suit ces liens lorsqu’il parcourt les emplacements ci-dessus.

Ces emplacements permettent de créer des skills et de les détecter localement. Pour distribuer des skills réutilisables au-delà d’un seul dépôt et, si vous le souhaitez, y associer des connecteurs, utilisez des plugins.

Distribuer des skills avec des plugins

Les dossiers de skills conviennent particulièrement à la création locale et aux workflows propres à un dépôt. Pour distribuer un skill réutilisable, regrouper plusieurs skills ou fournir un skill avec un connecteur, intégrez les éléments concernés à un plugin.

Un plugin peut contenir un ou plusieurs skills. Il peut aussi réunir dans un même paquet des connexions à des serveurs MCP enregistrées au préalable, des configurations de serveurs MCP et des ressources de présentation.

Installer des skills sélectionnés pour un usage local

Pour compléter les skills intégrés à votre installation locale de Codex avec des skills issus d’une sélection, utilisez $skill-installer. Par exemple, pour installer le skill $linear :

$skill-installer linear

Vous pouvez aussi demander à l’outil d’installation de télécharger des skills depuis d’autres dépôts. Codex détecte automatiquement les nouveaux skills. Si l’un d’eux n’apparaît pas, redémarrez Codex.

Utilisez cette méthode pour configurer votre environnement local et expérimenter. Pour distribuer vos propres skills afin que d’autres puissent les réutiliser, privilégiez les plugins.

Activer ou désactiver les skills locaux de Codex

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

Utilisez exactement un sélecteur par entrée. Un chemin absolu indiqué dans path désigne un seul fichier SKILL.md. Le sélecteur name s’applique à tous les skills portant le nom indiqué. Si plusieurs entrées correspondent à un skill, la dernière entrée correspondante l’emporte.

Pour désactiver tous les skills système fournis avec Codex pour le projet actuel, ajoutez ce paramètre au fichier de configuration de confiance .codex/config.toml du projet :

[skills.bundled]
enabled = false

Redémarrez Codex après avoir modifié la configuration.

Métadonnées facultatives

Ajoutez un fichier agents/openai.yaml pour configurer les métadonnées d’interface dans l’application de bureau ChatGPT, définir les règles d’invocation du skill et déclarer les outils dont il dépend. Ces réglages facilitent l’utilisation du skill.

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) : avec la valeur false, Codex n’invoque pas implicitement le skill en fonction du prompt de l’utilisateur. L’invocation explicite avec $skill reste possible.

Bonnes pratiques

• Limitez chaque skill à une seule tâche.
• Privilégiez les instructions. Utilisez des scripts si vous avez besoin d’un comportement déterministe ou d’outils externes.
• Rédigez les étapes à l’impératif et précisez les entrées et les sorties attendues.
• Testez des prompts en vous appuyant sur la description du skill pour vérifier qu’il se déclenche dans les cas prévus.

Pour d’autres exemples, consultez le skill de réparation de la CI sur GitHub, les skills PDF et Linear, le dépôt openai/skills et la spécification des skills d’agent. Pour distribuer des skills que d’autres personnes pourront installer, privilégiez les plugins.