Agent Development

Guía de referencia para escribir archivos .md de subagentes de Claude Code: frontmatter, ejemplos de activación, prompts del sistema.

Por troykelly · troykelly/claude-skills

Probado · Funciona ★ 8.0/10

Agent Development — Guía de referencia para escribir archivos .md de subagentes de Claude Code: frontmatter, ejemplos de activación, prompts del sistema.

Qué hace

Documenta el formato completo de archivo de agente para plugins de Claude Code - campos de frontmatter requeridos (name, description, model, color, tools), cómo escribir bloques <example> de activación en la descripción y una plantilla de prompt del sistema (responsabilidades/proceso/salida/casos límite). Se activa cuando un usuario quiere crear, escribir o corregir un subagente, su frontmatter o su descripción de activación.

Informe de la prueba

La guía escrita produce un archivo de agente genuinamente bien estructurado (descripción multilínea con bloques <example>/<commentary>, prompt del sistema en segunda persona, herramientas de menor privilegio) versus una línea base ingenua escrita a mano que carece de todo eso - pero la única herramienta incluida, validate-agent.sh, se atora con ese formato exacto de descripción multilínea recomendado (extracción grep de una sola línea) y sale prematuramente debido a su propio error set -e + ((warning_count++)), y el segundo script prometido, scripts/test-agent-trigger.sh, no está en el repositorio en absoluto.

Probado el: 2026-07-16 · Claude Code 2.x (agent harness)

Instalación

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

Comandos y prompts de ejemplo

  • /agent-developmentGuía de referencia para escribir archivos .md de subagentes de Claude Code: frontmatter, ejemplos de activación, prompts del sistema.

Los skills se activan con peticiones en lenguaje natural, sin comandos que memorizar. Tras instalarlo, prompts como estos lo activan (en inglés):

  • 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