Comandos slash personalizados
Un comando slash personalizado empaqueta un prompt que reescribes una y otra vez en un único /palabra. Defínelo una vez; reutilízalo para siempre (y compártelo con tu equipo).
- Explicar qué es un comando slash personalizado y por qué es mejor que reescribir un prompt
- Crear un comando colocando un archivo Markdown en el directorio correcto
- Distinguir los comandos de proyecto de los personales por su ubicación
- Usar los bloques de construcción: $ARGUMENTS, salida de bash incrustada, referencias a archivos y frontmatter
- Elegir entre un comando slash, una skill y un subagente para una tarea dada
Cómo funcionan
Un comando es simplemente un archivo Markdown. Colócalo en tu directorio de comandos y su nombre de archivo pasa a ser el comando. El cuerpo del archivo es el prompt que ejecuta Claude cuando lo invocas.
La ubicación del archivo decide su alcance:
- Guárdalo en .claude/commands/changelog.md → /changelog. Vive en el repositorio, así que todo el equipo lo obtiene.
- Guárdalo en ~/.claude/commands/changelog.md → /changelog. Te sigue por todos los proyectos de tu máquina.
- Escribe la /palabra en Claude Code. El cuerpo del archivo pasa a ser el prompt que ejecuta Claude.
- El nombre de archivo —no el frontmatter— pasa a ser el nombre del comando. changelog.md siempre es /changelog.
Un ejemplo mínimo
Aquí tienes un archivo de comando completo. El frontmatter contiene la description; todo lo que hay debajo es el prompt.
commit.md — redactar un Conventional Commit
--- description: Draft a Conventional Commit message from the staged diff --- Look at the staged changes with `git diff --cached` and write a single Conventional Commit message (feat/fix/docs/refactor/chore). Output only the message, no preamble.
Guárdalo como commit.md y /commit lo hace cada vez. (Ponle el nombre que tenga el archivo — el mismo cuerpo guardado como changelog.md sería /changelog).
Los bloques de construcción útiles
Cuatro ingredientes convierten un prompt estático en un comando flexible:
| Bloque de construcción | Qué hace |
|---|---|
$ARGUMENTS | Inyecta lo que el usuario escribió tras el comando. /review src/auth.ts → la ruta acaba en tu prompt. |
| Ejecutar bash e incrustar la salida | Los comandos pueden incluir la salida de shell (p. ej. el diff actual) para que Claude actúe sobre el estado en vivo. |
| Referenciar archivos | Apunta a archivos para incluir su contenido. |
| Frontmatter | description (que se muestra en el menú) y otras opciones. |
Consulta la documentación oficial para la sintaxis exacta de argumentos, bash y referencias a archivos.
Comandos que vale la pena robar
Hay un conjunto inicial en nuestra Biblioteca de comandos slash: mensaje de commit, descripción de PR, revisión de código, changelog, scaffold de un componente.
Comando frente a skill frente a subagente
Tres formas de empaquetar trabajo — la diferencia está en quién lo dispara y cuán aislado se ejecuta:
- Comando slash — tú disparas un flujo de trabajo conocido bajo demanda.
- Skill — Claude carga experiencia automáticamente cuando es relevante.
- Subagente — delega una parte del trabajo a un agente aislado.