Skill Tool Design
Progetta contratti degli strumenti con input, output, criteri di scelta ed errori recuperabili espliciti.
Community · Muratcan Koylan| Autore | Muratcan Koylan |
|---|---|
| Licenza | MIT |
| Fonte | muratcankoylan/Agent-Skills-for-Context-Engineering · SKILL.md su GitHub |
| Funziona in | Claude Code · Codex, Gemini CLI, Cursor, Copilot |
| Letta dalla fonte il |
Lo skill tool-design migliora l’interfaccia tra agente e strumenti richiamabili.
Ogni strumento è un contratto: quando sceglierlo, quali input accetta, cosa restituisce e come recuperare dopo un errore. Non implementa il backend.
Dallo SKILL.md della skill: ## Gotchas
Cosa fa
- Esaminare nomi sovrapposti e descrizioni ambigue.
- Definire parametri, formati di risposta e recupero errori.
- Provare scelta e utilizzo dello strumento previsto.
Cosa ottieni
- Contratti, descrizioni aggiornate e un piano di validazione.
Quando usarla
- L’agente sceglie strumenti errati o fornisce ripetutamente argomenti non validi.
Quando non usarla
- Scegliere l’intera architettura o unire operazioni estranee in uno strumento eccessivo.
Cosa richiede
- Un agente con file e schemi, comportamenti ed errori reali degli strumenti.
- Il generatore Python usa modelli e punteggi euristici; non dimostra una migliore selezione reale.
File della skill
| File o cartella | A cosa serve |
|---|---|
SKILL.md | Guida ai contratti, esempi ed errori di progettazione. |
references/best_practices.md | Generatore Python di descrizioni e riferimenti su progettazione e consolidamento. |
scripts/description_generator.py | Generatore Python di descrizioni e riferimenti su progettazione e consolidamento. |
Licenza trovata nel repository il 2026-11-20: MIT.
Prompt di esempio
Scrivine uno dopo l'installazione; nominare la skill fa sì che venga usata.
- Riscrivi questo contratto con valori predefiniti ed errori recuperabili espliciti.
- Esamina questi nomi sovrapposti prima di proporre consolidamenti.
- Progetta risposte brevi e dettagliate per la stessa ricerca.
Come installare tool-design
Conservare riferimenti ed esempi
Copia l’intera cartella. Il plugin installa la raccolta; usa l’installazione della cartella per un singolo skill.
Guida e modelli Python non richiedono servizi esterni. I test reali necessitano del tuo agente e backend; caricamento ospitato ed API non verificati qui.
Una skill è una cartella con un file SKILL.md. La installi una volta sola; l'agente legge la sua breve descrizione all'inizio di ogni sessione e carica le istruzioni complete solo quando una richiesta corrisponde. Scegli dove la usi:
Claude Code: dal marketplace dei plugin
- Avvia Claude Code in un terminale con
claude. - Aggiungi il marketplace (una volta per computer):
/plugin marketplace add muratcankoylan/Agent-Skills-for-Context-Engineering - Installa il plugin. Claude Code ne mostra prima i dettagli: controlla cosa aggiungerà (skill, hook, server MCP), poi scegli se è per te, per tutti su questo repository o solo per te in questo repository.
/plugin install context-engineering@context-engineering-marketplace - Digita / e cerca
/context-engineering:tool-design, oppure chiedi semplicemente di svolgere il compito.
Dalla shell invece che da una sessione:
claude plugin marketplace add muratcankoylan/Agent-Skills-for-Context-Engineering
claude plugin install context-engineering@context-engineering-marketplaceIl plugin si installa per intero, quindi arrivano anche altre skill, tra cui 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: copia la cartella nella tua cartella delle skill
Metti la cartella della skill in ~/.claude/skills/ per usarla in tutti i progetti su questo computer, oppure in .claude/skills/ dentro un repository per condividerla con chiunque ci lavori (fanne il commit).
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 rileva le skill nuove o modificate in queste cartelle durante la sessione. Se la cartella delle skill non esisteva quando è iniziata la sessione, esegui una volta /reload-skills. Poi digita /tool-design o descrivi semplicemente il compito.
Su Windows, esegui i comandi in Git Bash o WSL, oppure copia la cartella nello stesso percorso con Esplora file.
Codex, Gemini CLI, Cursor e GitHub Copilot
Questi agenti leggono le stesse cartelle SKILL.md. L'unica cartella di progetto accettata da tutti e quattro è .agents/skills/, quindi questo comando ci copia la 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/| Agente | Cartella del progetto | La tua cartella utente | Note |
|---|---|---|---|
| OpenAI Codex | .agents/skills/ | ~/.agents/skills/ | Digita $ o esegui /skills per scegliere una skill; Codex ne sceglie una anche da solo quando il tuo compito corrisponde. |
| Gemini CLI | .agents/skills/.gemini/skills/ | ~/.agents/skills/~/.gemini/skills/ | Oppure installa da Git con gemini skills install <git URL> --path <folder> --consent. Il 18 giugno 2026 Google ha sostituito Gemini CLI con Antigravity CLI per gli utenti del piano gratuito e di Google One; Antigravity usa .agents/skills/ in un progetto e ~/.gemini/config/skills/ per te. |
| Cursor | .agents/skills/.cursor/skills/ | ~/.agents/skills/~/.cursor/skills/ | Digita / nella chat Agent per scegliere una skill. Cursor legge anche le cartelle .claude/skills/ di Claude Code. |
| GitHub Copilot | .github/skills/.agents/skills/.claude/skills/ | ~/.copilot/skills/~/.agents/skills/ | Funziona in Copilot CLI, nel cloud agent e nella modalità agente di VS Code, Visual Studio e JetBrains (il supporto negli IDE dipende dalla versione). Oppure esegui gh skill install OWNER/REPOSITORY SKILL (anteprima pubblica, GitHub CLI 2.90.0 o successiva). |
Fonti per questi passaggi
Verificati sulla documentazione di ciascun fornitore il 2026-11-14:
Un contratto per l’azione successiva
Nomi e descrizioni devono distinguere alternative reali. Specifica valori predefiniti, vincoli di input e struttura di output.
Offri risposte brevi o dettagliate secondo il compito. Gli errori devono consentire correzioni, non tentativi ciechi ripetuti.
Validare il consolidamento con compiti reali
Ridurre gli strumenti non garantisce prestazioni migliori. Confronta successo, errori negli argomenti e recupero sugli stessi compiti.
Il generatore abbozza descrizioni; le euristiche non verificano backend, permessi o comprensione dell’agente.
Domande su tool-design
Costruisce un server MCP?
No. Guida il contratto; trasporto, autenticazione ed esecuzione backend restano da implementare.
Conviene consolidare tutti gli strumenti?
No. Unisci compiti sovrapposti quando utile, separa operazioni diverse e prova la nuova interfaccia.
Cosa deve contenere un errore?
Cosa è fallito e quale input o stato cambiare prima di riprovare, senza esporre dettagli sensibili.
I punteggi di esempio misurano l’agente?
No. Controllano pattern e metadati. Valida selezione e recupero con esecuzioni rappresentative.
Altre skill IA
Skill correlate
Skill Dev-Browser
Community · Sawyer HoodAutomatizza Chrome con pagine persistenti, script Puppeteer e un servizio locale da riga di comando.Skill Agent Evaluation
Community · Muratcan KoylanPianifica regressioni con controlli deterministici, dimensioni separate e basi di confronto versionate.Skill Context Degradation
Community · Muratcan KoylanDiagnostica errori nei contesti lunghi e pianifica il recupero con fatti verificati e confronti specifici.Skill Advanced Evaluation
Community · Muratcan KoylanProgetta giudici LLM con rubriche basate su prove, confronti invertiti e calibrazione umana.Skill Brainstorming
Community · Jesse Vincent / Prime RadiantTrasforma un’idea iniziale in un progetto concordato prima di implementare.Skill Writing Plans
Community · Jesse Vincent / Prime RadiantConverti un progetto approvato in compiti revisionabili con interfacce e verifiche.