PARA TODOS — REFERENCIA RÁPIDA

Comandos y scripts

Esta es la página de consulta. Cada comando de claude-kit en un solo lugar, con qué hace y cuándo lo usarías. En el día a día solo necesitarás unos pocos — pero cuando quieras la imagen completa, está todo aquí.

Los slash commands los escribes dentro de Claude Code. Los scripts son la sala de máquinas que hay debajo — rara vez los ejecutas a mano, pero conviene saber que existen.

Slash commands

Estas son las cosas que escribes. Empieza con /kit-init; al resto recurrirás sobre la marcha.

Comando	Qué hace	Recurre a él cuando
/kit-init	Prepara un .claude/ a medida para tu proyecto a partir de un perfil de rol — agentes, skills, reglas, scripts, configuración.	Estás empezando en un proyecto nuevo. Ejecútalo una vez.
/kit-customize	Añade, edita o elimina agentes; conéctales skills y herramientas; pásales el linter; construye y guarda un perfil personalizado.	Quieres dar forma a quién está en tu equipo. (Se activa por sí solo cuando pides crear o editar un agente.)
/kit-annotate	Haz clic en cualquier parte de tu app React en ejecución y deja una nota; Claude la lee y arregla el código.	Estás revisando una app React y quieres señalar en lugar de describir.
/kit-update	Muestra un changelog en lenguaje claro y fusiona lo nuevo — sin tocar tus personalizaciones.	Ves un aviso de "update available".
/kit-docs	Abre las propias guías del kit dentro de Claude Code.	Quieres leer la documentación sin salir de tu editor.
/kit-contribute	Empaqueta un agente que construiste en una plantilla reutilizable y abre un pull request upstream.	Hiciste algo bueno y quieres compartirlo.

Flags útiles

Algunos comandos aceptan opciones. Las que vale la pena conocer:

Comando	Flag	Qué hace
/kit-init	--dry-run	Previsualiza toda la configuración y no escribe nada. Un primer vistazo seguro.
/kit-annotate	setup · watch · review · status	Elige el modo. watch es manos libres — Claude recoge las notas a medida que las añades.
/kit-update	(siempre previsualiza)	Muestra exactamente qué se añadirá o fusionará antes de escribir nada.

# Una primera sesión típica en un proyecto nuevo
/kit-init --dry-run    # mira primero
/kit-init              # luego configúralo de verdad

# Revisa una app React señalándola
/kit-annotate watch

Scripts entre bastidores

Los slash commands se apoyan en un pequeño conjunto de scripts de shell dentro de las carpetas .claude/ y scripts/ de tu proyecto. Casi nunca los llamas tú mismo — Claude los ejecuta por ti — pero aquí tienes de qué se encarga cada uno.

Script	De qué se encarga
init.sh	Prepara tu .claude/ a partir de un perfil. También ejecuta la actualización por fusión segura.
annotate-setup.sh	Conecta la barra de herramientas de anotación visual a una app React.
kit-version-check.sh	Comprueba discretamente si tu proyecto va por detrás del plugin instalado.
lib/react-detect.sh	Averigua si tienes una app React y qué framework.
lib/kit-config.sh	Lee los ajustes de tu proyecto para que los demás scripts conozcan tu configuración.
setup-labels.sh	Crea las etiquetas de issues (kind, priority, role) en tu repo de GitHub.
setup-milestones.sh	Crea los hitos de tu proyecto en el repo.
task-sync.sh	Imprime una instantánea de solo lectura de tu tablero de tareas, agrupada por rol.

nota

Las etiquetas, los hitos y la instantánea del tablero usan la CLI de GitHub (gh). Si no conectaste GitHub durante la configuración, esos scripts simplemente quedan inactivos — nada se rompe.

Cómo funciona por dentro

• init.sh — el preparador (scaffolder). scripts/init.sh --profile software --name "My App" sustituye {{VARS}} y resuelve los bloques <!-- IF:FLAG --> de un perfil de rol en un .claude/ nuevo. Los flags incluyen --profile <software|content|research|minimal>, --target <dir>, --name, --slug, --repo, --memory <on|off>, --speckit <on|off>, --prepush "<command>" y --lang. Dos modos importantes: --dry-run imprime el plan y no escribe nada, y --upgrade fusiona las nuevas funciones del kit en un .claude/ existente preservando tus ediciones (esto es lo que ejecuta /kit-update). Requiere jq y perl.

• annotate-setup.sh — scripts/annotate-setup.sh [--target DIR] [--framework next|vite|react-router] [--dry-run]. Instala la dependencia de desarrollo de terceros agentation, registra el servidor MCP agentation-mcp para Claude, escribe la regla react-annotate y registra la elección en kit.config.json. Imprime el snippet del provider solo-de-desarrollo para el entry de tu app en lugar de editar el código a ciegas — /kit-annotate aplica esa edición con tu confirmación. Sale limpiamente si no se detecta ninguna app React.

• kit-version-check.sh — kit-version-check.sh [--target DIR] [--plugin-root DIR] [--quiet]. Compara el kitVersion registrado del proyecto (de kit.config.json) contra la versión de plugin.json del plugin instalado usando un sort -V consciente de semver. Imprime un aviso de "update available" de una línea solo cuando el proyecto está estrictamente por detrás; en caso contrario, un no-op seguro. Tanto el hook de SessionStart como /kit-update lo llaman.

• lib/react-detect.sh — cárgalo (source) y luego llama a react_detect [dir]. Define variables REACT_*, detectando el framework por orden de especificidad: Next.js → React Router v7 → Vite → React genérico. (Una comprobación plana de "¿está Vite presente?" no es fiable, ya que las apps Next/RR a menudo llevan Vite para los tests.) También infiere el gestor de paquetes a partir del lockfile. Seguro de cargar (source) — nunca aborta al llamador.

• lib/kit-config.sh — source scripts/lib/kit-config.sh && load_kit_config carga .claude/kit.config.json en variables de entorno KIT_* (nombre del proyecto, perfil, repo, wing de memoria, formato de planes y más). Los archivos .claudekit/config.json por carpeta se fusionan en profundidad sobre la configuración del proyecto, ganando el más cercano — la misma cascada que .editorconfig.

• setup-labels.sh — idempotente. Lee el repo y los roles de la configuración, luego crea las familias de etiquetas kind:, priority: y role: en el repo vía gh label create --force. Las reejecuciones reportan (exists) en lugar de dar error.

• setup-milestones.sh — idempotente. Lee los hitos del proyecto de la configuración y crea los que aún no existen en el repo vía gh api.

• task-sync.sh — estado del tablero de solo lectura. ./scripts/task-sync.sh [--role <Name>] [--milestone <label>] lista los issues abiertos agrupados por rol como tablas Markdown, marcando los elementos bloqueados. Puro gh + jq, compatible con bash 3.2.

Ver también

• Mantente actualizado — /kit-update — la actualización segura en detalle.
• Ponerte en marcha — empieza con /kit-init y elige un perfil.