Tus primeros slash commands

Ya conoces los slash commands integrados (/clear, /model, /compact…). Lo que quizá no sabías es que puedes crear los tuyos, y que es tan simple como escribir un fichero markdown. En esta lección creas tu primer /comando.

Un comando es un fichero

Crea un fichero en .claude/commands/ con el nombre del comando. Por ejemplo, .claude/commands/test-fix.md:

Ejecuta la suite de tests. Si algo falla, diagnostica la causa y propón un fix,
pero NO lo apliques hasta que yo lo apruebe.

Eso es todo. En tu próxima sesión, al escribir /test-fix, Claude recibe ese texto como instrucción. Has convertido una petición que repetías en un comando de una palabra.

Dónde viven y para quién:

.claude/commands/<nombre>.md → del proyecto, se commitea, lo hereda el equipo.

~/.claude/commands/<nombre>.md → personal, disponible en todos tus repos.

Pasarle argumentos

Un comando se vuelve mucho más útil cuando acepta entrada. Usa $ARGUMENTS para todo lo que escribas después del nombre:

.claude/commands/fix-issue.md:

Arregla el issue de GitHub $ARGUMENTS siguiendo nuestras convenciones:
1. Lee la descripción del issue.
2. Implementa el fix.
3. Escribe un test.
4. Crea un commit.

Al ejecutar /fix-issue 123, Claude recibe "Arregla el issue de GitHub 123…". También puedes acceder a argumentos por posición con $0, $1, $2… — el índice empieza en 0 (p.ej. /migrate SearchBar React Vue → $0 es SearchBar, $1 es React, $2 es Vue).

Los integrados que conviene conocer

Más allá de los que ya usas, vale la pena tener en el radar:

Comando	Para qué
`/init`	genera un `CLAUDE.md` inicial analizando tu repo
`/plan`	entra en plan mode (explorar y proponer antes de tocar)
`/agents`	gestiona subagentes (curso siguiente)
`/context`	muestra en qué se está gastando la ventana de contexto
`/permissions`	revisa y edita las reglas de permisos

Escribe / en la sesión para ver la lista completa filtrable.

El puente a las skills

Aquí está el dato que lo cambia todo: los slash commands se han fusionado con las skills. Un fichero en .claude/commands/deploy.md y una skill en .claude/skills/deploy/SKILL.md crean los dos el comando /deploy y funcionan igual. Tus comandos actuales siguen funcionando tal cual.

¿Por qué pasar a skills entonces? Porque una skill puede hacer más: agrupar ficheros de soporte, decidir si la invocas tú o Claude, y cargarse automáticamente cuando es relevante. Eso es justo la siguiente lección.

Tu turno

Antes de seguir, crea un comando real sobre algo que repitas:

/review → "revisa el diff actual y señala riesgos antes de que commitee".
/changelog → "resume en bullets los commits desde la última tag".

Ese comando es ya el primer artefacto del curso.

Qué llevas hasta aquí

Un slash command es un fichero markdown en .claude/commands/ (proyecto) o ~/.claude/commands/ (personal).
Acepta argumentos con $ARGUMENTS (o $0, $1… por posición, desde 0).
Comandos y skills son el mismo mecanismo: las skills añaden superpoderes.

En la siguiente lección damos el salto: qué es una skill y cuándo la invoca Claude por su cuenta.

Fuente oficial: Commands · Skills

¿Quieres llevar la cuenta de las lecciones que has terminado?

Entrar para guardar progreso