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| Auteur | Muratcan Koylan |
|---|---|
| Licence | MIT |
| Source | muratcankoylan/Agent-Skills-for-Context-Engineering · SKILL.md sur GitHub |
| Fonctionne dans | Claude 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
Ce qu’il fait
- Examiner les noms redondants et les descriptions ambiguës.
- Définir paramètres, réponses et reprise après erreur.
- 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.md | Conseils de contrats, exemples et pièges de conception. |
references/best_practices.md | Générateur Python de descriptions et références de conception et consolidation. |
scripts/description_generator.py | Gé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
- Lancez Claude Code dans un terminal avec
claude. - Ajoutez la marketplace (une fois par ordinateur) :
/plugin marketplace add muratcankoylan/Agent-Skills-for-Context-Engineering - 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 - 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-marketplaceLe 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/| Agent | Dossier du projet | Votre dossier utilisateur | Remarques |
|---|---|---|---|
| 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). |
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
Skill Dev-Browser
Communauté · Sawyer HoodAutomatisez Chrome avec des pages nommées persistantes, Puppeteer et un service local en ligne de commande.Skill Agent Evaluation
Communauté · Muratcan KoylanPlanifiez des régressions avec contrôles déterministes, dimensions séparées et références versionnées.Skill Context Degradation
Communauté · Muratcan KoylanDiagnostiquez les échecs de contexte long et préparez une reprise avec des faits vérifiés et des comparaisons adaptées.Skill Advanced Evaluation
Communauté · Muratcan KoylanConcevez des juges LLM avec grilles étayées, comparaisons inversées et calibration humaine.Skill Brainstorming
Communauté · Jesse Vincent / Prime RadiantTransformez une idée initiale en conception approuvée avant de coder.Skill Writing Plans
Communauté · Jesse Vincent / Prime RadiantTransformez une conception approuvée en tâches vérifiables, avec interfaces et contrôles.