Skills, slash commands, sub-agentes y MCP: el copiloto operativo

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.