Las cuatro piezas que convierten un boilerplate en un copiloto operativo. Qué son, cuándo usar cada una y cómo encajarlas en tu repo.
Skills, slash commands, sub-agentes y servidores MCP son las cuatro patas que convierten un boilerplate clásico en un copiloto operativo. Si nunca los has usado, parece jerga. En cuanto los metes en tu flujo, no quieres volver atrás.
Esta guía explica qué son, cuándo usar cada uno y cómo encajarlos en tu boilerplate.
Un slash command es una instrucción reutilizable que invocas con /. Lo defines una vez en
.claude/skills/ y a partir de ahí lo lanzas tantas veces como quieras.
Ejemplo: /verify
# Verify the project quality
Run all linters and the build:
1. Run `bun lint:all`
2. Run `bun run build`
3. Report any errors foundCuando escribes /verify, el agente ejecuta exactamente esos pasos. Sin tener que recordarlos.
Cuándo crear uno: cuando ves que repites las mismas instrucciones 3+ veces en distintas sesiones. Es el momento.
Una skill es como un slash command pero con más cuerpo: una guía completa para una tarea recurrente. Por ejemplo:
/new-feature → genera la estructura de una feature nueva siguiendo el patrón/release → cierra una versión, escribe changelog, taggea/sesion → documenta el trabajo de la sesión en tu sistemaLa diferencia con un slash command simple: las skills suelen tener varios pasos, ramas condicionales y referencias a otros archivos.
Un sub-agent es un agente con instrucciones propias y un rol específico. Vive en .claude/agents/ y
se invoca con @:
@architecture-auditor revisa este PR
@quality-checker verifica que no rompo nada
@code-reviewer dame un segundo par de ojosCada uno tiene contexto limpio (no carga toda la conversación) y un prompt especializado. Para tareas como auditar arquitectura o revisar código, dan resultados mejores que el agente generalista.
Cuándo usarlos: revisión, validación, búsqueda exhaustiva. Cualquier tarea que se beneficia de "ojos frescos" sin todo el ruido de la conversación.
MCP (Model Context Protocol) es el estándar para que un agente acceda a servicios externos.
Los más útiles en un boilerplate:
Configurar uno son 3 líneas en ~/.claude/mcp.json. Y de pronto el agente deja de inventar APIs
porque puede consultar las reales.
| Pieza | Para qué |
|---|---|
| Slash command | Atajo a 3-10 pasos repetitivos |
| Skill | Tarea compleja con múltiples ramas |
| Sub-agent | Especialista con contexto limpio |
| MCP server | Acceso a datos/servicios reales |
Un flujo típico bien montado:
/new-feature blog-comments@architecture-auditor para validar@github MCPTú no has tecleado nada después del prompt inicial.
1. Crear skills demasiado pronto: si solo has hecho una tarea 1 vez, no es skill. Espera al patrón.
2. Sub-agent que duplica al principal: si hace lo mismo, no aporta. El sub-agent debe tener prompt distinto y rol claro.
3. MCPs sin documentar: tu agente sabe que existe @github MCP, pero no para qué lo usas en
este proyecto. Añade nota en CLAUDE.md.
4. Slash commands con paths absolutos: si el slash command usa /Users/..., no funciona en otra
máquina. Usa rutas relativas.
Skills, slash commands, sub-agents y MCP no son features sueltas. Son las herramientas que convierten un repo en un copiloto.
Si tu boilerplate las trae configuradas y documentadas, abrirlo es enchufar un coche con arrancador. Si no, es empujarlo cuesta arriba.
La diferencia se nota desde la primera sesión.
Suscríbete para más tutoriales y tips sobre crear productos con IA
Cómo se trabaja end-to-end con Claude Code sobre un boilerplate AI-native. Qué hace el humano, qué hace el agente, y por qué el resultado es 5x más rápido.