Vai al contenuto

Skill Tool Design

Progetta contratti degli strumenti con input, output, criteri di scelta ed errori recuperabili espliciti.

Community · Muratcan Koylan
AutoreMuratcan Koylan
LicenzaMIT
Fontemuratcankoylan/Agent-Skills-for-Context-Engineering · SKILL.md su GitHub
Funziona inClaude 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

Questa è una skill della community di Muratcan Koylan, non verificata da noi né da Anthropic. Le skill possono dire all'agente di eseguire codice, leggere file o accedere alla rete. Prima di installarla, leggi il suo SKILL.md e ogni script nella cartella, e cerca qualsiasi cosa che non corrisponda a ciò che dichiara di fare.

Cosa fa

  1. Esaminare nomi sovrapposti e descrizioni ambigue.
  2. Definire parametri, formati di risposta e recupero errori.
  3. 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 cartellaA cosa serve
SKILL.mdGuida ai contratti, esempi ed errori di progettazione.
references/best_practices.mdGeneratore Python di descrizioni e riferimenti su progettazione e consolidamento.
scripts/description_generator.pyGeneratore 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

  1. Avvia Claude Code in un terminale con claude.
  2. Aggiungi il marketplace (una volta per computer):
    /plugin marketplace add muratcankoylan/Agent-Skills-for-Context-Engineering
  3. 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
  4. 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-marketplace

Il 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/
AgenteCartella del progettoLa tua cartella utenteNote
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).
Installa solo skill di cui ti fidi. Anthropic consiglia di usare solo skill di fonti affidabili e di leggere ogni file di qualsiasi altra skill prima di usarla: una skill può indurre l'agente a eseguire comandi, leggere file o inviare dati in modi che la sua descrizione non menziona.

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

Categorie di skill