Agent Development

Guida di riferimento per scrivere file .md di subagenti Claude Code: frontmatter, esempi di trigger, prompt di sistema.

di troykelly · troykelly/claude-skills

Promosso ★ 8.0/10

Agent Development — Guida di riferimento per scrivere file .md di subagenti Claude Code: frontmatter, esempi di trigger, prompt di sistema.

Cosa fa

Documenta il formato completo del file agente per i plugin Claude Code - campi frontmatter richiesti (nome, descrizione, modello, colore, strumenti), come scrivere blocchi <example> di trigger nella descrizione e un modello di prompt di sistema (responsabilità/processo/output/casi limite). Si attiva quando un utente vuole creare, scrivere o correggere un subagente, il suo frontmatter o la sua descrizione di trigger.

Rapporto di test

La guida scritta produce un file agente genuinamente ben strutturato (descrizione multi-linea con blocchi <example>/<commentary>, prompt di sistema in seconda persona, strumenti a privilegi minimi) rispetto a una linea di base scritta a mano ingenua che manca di tutto ciò — ma l'unico strumento bundle, validate-agent.sh, si blocca su quel formato esatto di descrizione multi-linea raccomandato (estrazione grep su una riga) ed esce presto a causa del suo bug -e + ((warning_count++)), e il secondo script promesso, scripts/test-agent-trigger.sh, non è affatto nel repository.

Testato il: 2026-07-16 · Claude Code 2.x (agent harness)

Installazione

git clone https://github.com/troykelly/claude-skills
mkdir -p ~/.claude/skills
cp -r claude-skills/external/skills/agent-development ~/.claude/skills/agent-development

Comandi e prompt di esempio

  • /agent-developmentGuida di riferimento per scrivere file .md di subagenti Claude Code: frontmatter, esempi di trigger, prompt di sistema.

Gli skill si attivano con richieste in linguaggio naturale, senza comandi da ricordare. Dopo l'installazione, prompt come questi lo attivano (in inglese):

  • Write a subagent file for a dedicated code-review specialist
  • Help me fix the frontmatter on my custom Claude Code subagent
  • Draft triggering example blocks for my new agent's description