Aller au contenu

Skill Tool Design

Concevez des contrats d’outils avec entrées, sorties, critères de sélection et erreurs récupérables explicites.

Communauté · Muratcan Koylan
AuteurMuratcan Koylan
LicenceMIT
Sourcemuratcankoylan/Agent-Skills-for-Context-Engineering · SKILL.md sur GitHub
Fonctionne dansClaude Code · Codex, Gemini CLI, Cursor, Copilot
Lu à la source le

Le skill tool-design améliore l’interface entre un agent et les outils qu’il appelle.

Chaque outil est un contrat : quand le choisir, quelles entrées fournir, ce qu’il renvoie et comment reprendre après une erreur. Il ne construit pas le backend.

Extrait du SKILL.md du skill : ## Gotchas

Ceci est un skill de la communauté créé par Muratcan Koylan, vérifié ni par nous ni par Anthropic. Un skill peut demander à l’agent d’exécuter du code, de lire des fichiers ou d’accéder au réseau. Avant de l’installer, lisez son SKILL.md et chaque script du dossier, et cherchez tout ce qui ne correspond pas à ce qu’il prétend faire.

Ce qu’il fait

  1. Examiner les noms redondants et les descriptions ambiguës.
  2. Définir paramètres, réponses et reprise après erreur.
  3. Tester le choix et l’utilisation de l’outil prévu.

Ce que vous obtenez

  • Des contrats, des descriptions révisées et un plan de validation.

Quand l’utiliser

  • Un agent choisit le mauvais outil ou fournit souvent des arguments invalides.

Quand ne pas l’utiliser

  • Choisir toute l’architecture ou fusionner des opérations sans rapport dans un outil trop vaste.

Ce qu’il faut

  • Un agent avec accès aux fichiers, et les schémas, comportements et erreurs réels des outils.
  • Le générateur Python utilise des modèles et scores heuristiques ; il ne démontre pas une meilleure sélection réelle.

Fichiers du skill

Fichier ou dossierÀ quoi il sert
SKILL.mdConseils de contrats, exemples et pièges de conception.
references/best_practices.mdGénérateur Python de descriptions et références de conception et consolidation.
scripts/description_generator.pyGénérateur Python de descriptions et références de conception et consolidation.

Licence trouvée dans le dépôt le 2026-11-20 : MIT.

Exemples de prompts

Tapez l’un de ces prompts après l’installation ; nommer le skill garantit qu’il sera utilisé.

  • Réécris ce contrat avec valeurs par défaut et erreurs récupérables explicites.
  • Examine ces noms redondants avant de proposer une consolidation.
  • Conçois des réponses courtes et détaillées pour la même recherche.

Comment installer tool-design

Conserver références et exemples

Copiez tout le dossier. Le plugin installe la collection ; utilisez le dossier seul pour installer un unique skill.

Le guide et les modèles Python ne nécessitent aucun service externe. Les essais réels demandent votre agent et vos outils ; téléversement hébergé et exécution API non vérifiés ici.

Un skill est un dossier contenant un fichier SKILL.md. Vous l’installez une fois ; l’agent lit sa courte description au début de chaque session et ne charge les instructions complètes que si une demande correspond. Choisissez l’environnement que vous utilisez :

Claude Code : depuis la marketplace de plugins

  1. Lancez Claude Code dans un terminal avec claude.
  2. Ajoutez la marketplace (une fois par ordinateur) :
    /plugin marketplace add muratcankoylan/Agent-Skills-for-Context-Engineering
  3. Installez le plugin. Claude Code affiche d’abord ses détails : vérifiez ce qu’il va ajouter (skills, hooks, serveurs MCP), puis choisissez s’il est pour vous, pour toutes les personnes de ce dépôt, ou pour vous seul dans ce dépôt.
    /plugin install context-engineering@context-engineering-marketplace
  4. Tapez / et cherchez /context-engineering:tool-design, ou demandez simplement la tâche.

Depuis votre shell plutôt que dans une session :

claude plugin marketplace add muratcankoylan/Agent-Skills-for-Context-Engineering
claude plugin install context-engineering@context-engineering-marketplace

Le plugin s’installe en bloc : d’autres skills sont donc installés avec lui, dont context-fundamentals, context-degradation, context-compression, context-optimization, self-managed-context, multi-agent-patterns, long-horizon-prompting, memory-systems, filesystem-context, hosted-agents, evaluation, advanced-evaluation, harness-engineering, project-development, bdi-mental-states, latent-briefing, self-improvement-loops.

Claude Code : copier le dossier dans votre dossier de skills

Placez le dossier du skill dans ~/.claude/skills/ pour l’utiliser dans tous les projets de cet ordinateur, ou dans .claude/skills/ à l’intérieur d’un dépôt pour le partager avec toutes les personnes qui y travaillent (committez-le).

git clone --depth 1 https://github.com/muratcankoylan/Agent-Skills-for-Context-Engineering.git
mkdir -p ~/.claude/skills
cp -R Agent-Skills-for-Context-Engineering/skills/tool-design ~/.claude/skills/

Claude Code détecte pendant la session les skills nouveaux ou modifiés dans ces dossiers. Si le dossier de skills n’existait pas au démarrage de la session, lancez /reload-skills une fois. Tapez ensuite /tool-design ou décrivez simplement la tâche.

Sous Windows, lancez les commandes dans Git Bash ou WSL, ou copiez le dossier au même endroit avec l’Explorateur de fichiers.

Codex, Gemini CLI, Cursor et GitHub Copilot

Ces agents lisent les mêmes dossiers SKILL.md. Le seul dossier que les quatre acceptent dans un projet est .agents/skills/ ; cette commande y copie donc le skill :

git clone --depth 1 https://github.com/muratcankoylan/Agent-Skills-for-Context-Engineering.git
mkdir -p .agents/skills
cp -R Agent-Skills-for-Context-Engineering/skills/tool-design .agents/skills/
AgentDossier du projetVotre dossier utilisateurRemarques
OpenAI Codex
.agents/skills/
~/.agents/skills/
Tapez $ ou lancez /skills pour choisir un skill ; Codex en choisit aussi un quand votre tâche correspond.
Gemini CLI
.agents/skills/
.gemini/skills/
~/.agents/skills/
~/.gemini/skills/
Ou installez-le depuis Git avec gemini skills install <git URL> --path <folder> --consent. Le 18 juin 2026, Google a remplacé Gemini CLI par Antigravity CLI pour les utilisateurs de l’offre gratuite et de Google One ; Antigravity utilise .agents/skills/ dans un projet et ~/.gemini/config/skills/ pour vous.
Cursor
.agents/skills/
.cursor/skills/
~/.agents/skills/
~/.cursor/skills/
Tapez / dans le chat Agent pour choisir un skill. Cursor lit aussi les dossiers .claude/skills/ de Claude Code.
GitHub Copilot
.github/skills/
.agents/skills/
.claude/skills/
~/.copilot/skills/
~/.agents/skills/
Fonctionne dans Copilot CLI, l’agent cloud et le mode agent de VS Code, Visual Studio et JetBrains (la prise en charge dans l’IDE dépend de la version). Ou lancez gh skill install OWNER/REPOSITORY SKILL (préversion publique, GitHub CLI 2.90.0 ou ultérieure).
N’installez que des skills de confiance. Anthropic conseille de n’utiliser que des skills provenant de sources de confiance, et de lire chaque fichier de tout autre skill avant de l’utiliser : un skill peut amener l’agent à exécuter des commandes, lire des fichiers ou envoyer des données d’une manière que sa description ne mentionne pas.

Sources de ces étapes

Vérifiées dans la documentation de chaque éditeur le 2026-11-14 :

Un contrat qui permet l’action suivante

Noms et descriptions doivent distinguer les alternatives réelles. Précisez valeurs par défaut, contraintes et structure de sortie.

Proposez des réponses courtes ou détaillées selon la tâche. Les erreurs doivent permettre une correction plutôt que des tentatives aveugles répétées.

Valider la consolidation sur les tâches réelles

Réduire le nombre d’outils n’est pas une garantie de performance. Comparez réussite, arguments invalides et reprise sur les mêmes tâches.

Le générateur rédige des descriptions ; ses heuristiques ne vérifient ni backend, ni autorisations, ni compréhension par l’agent.

Questions sur tool-design

Construit-il un serveur MCP ?

Non. Il guide le contrat ; transport, authentification et exécution du backend restent à implémenter.

Faut-il consolider tous les outils ?

Non. Regroupez les tâches qui se recoupent si utile, séparez les autres et testez l’interface obtenue.

Que doit contenir une réponse d’erreur ?

Ce qui a échoué et l’entrée ou l’état à modifier avant un nouvel essai, sans révéler de détails sensibles.

Les scores d’exemple mesurent-ils les performances de l’agent ?

Non. Ils vérifient motifs textuels et métadonnées. Validez sélection et reprise avec des exécutions représentatives.

Plus de skills IA

Skills similaires

Catégories de skills