Saltar a contenido

rai skill

Gestiona skills de RaiSE. Los skills son flujos de trabajo estructurados (archivos SKILL.md) que guían a los agentes de IA a través de las fases del ciclo de vida del desarrollo.

rai skill list

Lista todos los skills en el directorio de skills. Muestra los skills agrupados por ciclo de vida con versión y descripción.

Flag Corta Descripción
--format -f Formato de salida: human, json. Por defecto: human
rai skill list
rai skill list --format json

rai skill validate

Valida la estructura de un skill contra el esquema de RaiSE. Verifica el frontmatter, los campos requeridos, las secciones y las convenciones de nomenclatura.

Argumento Descripción
PATH Ruta al archivo o directorio de skill (opcional — valida todos si se omite)
Flag Corta Descripción
--format -f Formato de salida: human, json. Por defecto: human
# Validar todos los skills
rai skill validate

# Validar un skill específico
rai skill validate .claude/skills/rai-story-start/SKILL.md

Códigos de salida: 0 todos válidos, 1 se encontraron errores de validación.


rai skill check-name

Verifica un nombre de skill propuesto contra las convenciones de nomenclatura. Valida el patrón {dominio}-{acción}, comprueba conflictos con skills existentes o comandos CLI, y verifica el dominio del ciclo de vida.

Argumento Descripción
NAME Nombre de skill propuesto (requerido)
Flag Corta Descripción
--format -f Formato de salida: human, json. Por defecto: human
rai skill check-name story-validate

rai skill scaffold

Crea un nuevo skill desde una plantilla. Genera un archivo SKILL.md con la estructura adecuada.

Argumento Descripción
NAME Nombre del skill a crear (requerido)
Flag Corta Descripción
--lifecycle -l Ciclo de vida: session, epic, story, discovery, utility, meta. Se infiere del nombre si no se especifica
--after Skill que debe ir antes que este
--before Skill que debe ir después de este
--set Skill set en el que crear (crea en .raise/skills/{set}/)
--from-builtin Copia desde el skill built-in desplegado como punto de partida (requiere --set)
--format -f Formato de salida: human, json. Por defecto: human
# Crear un nuevo skill de story
rai skill scaffold story-validate

# Con ciclo de vida y orden
rai skill scaffold story-validate --lifecycle story --after story-implement --before story-close

# Crear en un skill set desde un built-in
rai skill scaffold story-validate --set my-team --from-builtin

rai skill check-updates

Verifica la actualidad de los skills contra la versión del paquete instalado. Reporta cuáles skills están actualizados, desactualizados o tienen conflictos.

Flag Corta Descripción
--path -p Ruta del proyecto
rai skill check-updates
rai skill check-updates --path /path/to/project

Códigos de salida: 0 todos actualizados, 1 hay actualizaciones disponibles.


rai skill sync

Propaga los skills desde .claude/skills/ (Fuente Única de Verdad) hacia skills_base/ y .agent/skills/. Comando para desarrolladores de raise-commons. (ADR-074 D3)

Flag Descripción
--check Ejecución seca: reporta drift sin modificar archivos. Sale con 1 si hay drift, 0 si está limpio.
--include-internal También sincroniza skills internos a skills_base/.
--project, -p Raíz del proyecto (por defecto: directorio actual).
rai skill sync
rai skill sync --check
rai skill sync --include-internal

Códigos de salida: 0 éxito / limpio, 1 drift detectado (--check) o error.


rai skill set create

Crea un nuevo skill set desde los built-ins. Copia todos los skills built-in en .raise/skills/<name>/ como base inicial para personalización.

Argumento Descripción
NAME Nombre del skill set (requerido)
Flag Corta Descripción
--empty Crea un set vacío (sin copiar los built-ins)
--format -f Formato de salida: human, json. Por defecto: human
# Crear desde los built-ins
rai skill set create my-team

# Crear un set vacío
rai skill set create my-team --empty

rai skill set list

Lista todos los skill sets en .raise/skills/.

Flag Corta Descripción
--format -f Formato de salida: human, json. Por defecto: human
rai skill set list

rai skill set diff

Compara un skill set contra los built-ins. Muestra qué skills se han añadido, modificado o permanecen iguales.

Argumento Descripción
NAME Nombre del skill set a comparar (requerido)
Flag Corta Descripción
--format -f Formato de salida: human, json. Por defecto: human
rai skill set diff my-team

Ver también: rai init --skill-set