Skills, slash commands, sub-agentes y MCP: el copiloto operativo
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.
Israel Palma
3 min de lectura
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.
## Slash commands: el atajo
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`
```markdown
# Verify the project quality
Run all linters and the build:
1. Run `bun lint:all`
2. Run `bun run build`
3. Report any errors found
```
Cuando 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.
## Skills: instrucciones más largas
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 sistema
La diferencia con un slash command simple: las skills suelen tener varios pasos, ramas condicionales
y referencias a otros archivos.
## Sub-agentes: especialistas
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 ojos
```
Cada 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 servers: conexión con el mundo real
MCP (Model Context Protocol) es el estándar para que un agente acceda a servicios externos.
Los más útiles en un boilerplate:
- **Context7**: docs en vivo de librerías. Pregúntale por la API actual de Next.js y la trae sin
inventar.
- **GitHub**: leer issues, abrir PRs, comentar.
- **Linear / Jira**: leer y crear tareas.
- **Discord / Slack**: publicar updates al equipo.
- **Filesystem extendido**: acceso a fuera del proyecto si lo necesitas.
Configurar uno son 3 líneas en `~/.claude/mcp.json`. Y de pronto el agente deja de inventar APIs
porque puede consultar las reales.
## Cómo encajan los cuatro
| 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:
1. Tecleas `/new-feature blog-comments`
2. El skill arranca, pregunta dudas, scaffold la estructura
3. El skill llama a `@architecture-auditor` para validar
4. El skill consulta el MCP de Context7 para ver la API más reciente que usar
5. El skill abre PR con `@github` MCP
Tú no has tecleado nada después del prompt inicial.
## Errores comunes
**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.
## Conclusión
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.
¿Te gustó este artículo?
Suscríbete para más tutoriales y tips sobre crear productos con IA