Créer des skills

Utilisez les skills d’agent pour doter ChatGPT et Codex de fonctionnalités propres à certaines tâches. Un skill regroupe des instructions, des ressources et, éventuellement, des scripts afin que chaque produit puisse suivre un flux de travail de manière fiable. Les skills reposent sur la norme ouverte relative aux skills d’agent.

Les skills constituent le format de création des flux de travail réutilisables. Les plugins distribuent des skills et connecteurs réutilisables par l’intermédiaire du répertoire universel de plugins partagé par ChatGPT et Codex. Les plugins fonctionnent dans Chat et Work sur ChatGPT pour le web, les ordinateurs et les appareils mobiles, dans Codex au sein de l’application de bureau ChatGPT, ainsi que via Codex CLI. Utilisez les skills pour concevoir le flux de travail lui-même, puis regroupez-le dans un plugin lorsque vous souhaitez permettre à d’autres personnes de l’installer.

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

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.

Dans Codex, la liste initiale inclut également le chemin du fichier de chaque skill. Pour éviter de réduire l’espace disponible pour le reste du prompt, cette liste utilise au maximum 2 % de la fenêtre de contexte du modèle, ou 8 000 caractères lorsque la taille de cette fenêtre est inconnue. Si de nombreux skills sont installés, Codex raccourcit d’abord leur description. Pour les ensembles de skills volumineux, 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.

Comment ChatGPT et Codex utilisent les skills

ChatGPT et Codex peuvent activer des skills de deux manières :

1. Invocation explicite : incluez directement le skill dans votre prompt. Dans ChatGPT, saisissez @ pour sélectionner un skill. Dans Codex CLI ou l’extension 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 à la description du skill.

Comme la correspondance implicite dépend de description, rédigez des descriptions concises avec une portée et des limites claires. Placez au début le cas d’usage principal et les mots déclencheurs afin qu’un hôte puisse toujours identifier le skill si les descriptions sont raccourcies.

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 Enregistrer et reproduire. L’enregistreur capture le workflow, examine les étapes et crée l’ébauche d’un skill réutilisable à partir de la démonstration.

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

$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 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.

Emplacements depuis lesquels Codex charge les skills locaux

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 locales. 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 conviennent particulièrement à la création locale et aux workflows limités à un dépôt. Si vous souhaitez distribuer un skill réutilisable, regrouper plusieurs skills ou fournir un skill avec un connecteur, empaquetez-les sous la forme d’un plugin.

Les plugins peuvent inclure un ou plusieurs skills. Ils peuvent aussi éventuellement regrouper des connexions enregistrées à des serveurs MCP, une configuration intégrée de serveur MCP et des ressources de présentation dans un même package.

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 les skills Codex locaux

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 consulter d’autres exemples, reportez-vous à Réparation de CI GitHub, PDF, Linear, openai/skills et à la spécification des skills d’agent. Pour une distribution installable, privilégiez les plugins.