rai skill

Manage RaiSE skills. Skills are structured workflows (SKILL.md files) that guide AI agents through development lifecycle phases.

rai skill list

List all skills in the skill directory. Shows skills grouped by lifecycle with version and description.

Flag	Short	Description
--format	-f	Output format: human, json. Default: human

rai skill list
rai skill list --format json

---

rai skill validate

Validate skill structure against the RaiSE schema. Checks frontmatter, required fields, sections, and naming conventions.

Argument	Description
PATH	Path to skill file or directory (optional — validates all if omitted)

Flag	Short	Description
--format	-f	Output format: human, json. Default: human

# Validate all skills
rai skill validate

# Validate specific skill
rai skill validate .claude/skills/rai-story-start/SKILL.md

Exit codes: 0 all valid, 1 validation errors found.

---

rai skill check-name

Check a proposed skill name against naming conventions. Validates {domain}-{action} pattern, checks for conflicts with existing skills or CLI commands, and verifies the lifecycle domain.

Argument	Description
NAME	Proposed skill name (required)

Flag	Short	Description
--format	-f	Output format: human, json. Default: human

rai skill check-name story-validate

---

rai skill scaffold

Create a new skill from template. Generates a SKILL.md file with proper structure.

Argument	Description
NAME	Skill name to create (required)

Flag	Short	Description
--lifecycle	-l	Lifecycle: session, epic, story, discovery, utility, meta. Inferred from name if not set
--after		Skill that should come before this one
--before		Skill that should come after this one
--set		Skill set to create in (creates in .raise/skills/{set}/)
--from-builtin		Copy from deployed builtin skill as starting point (requires --set)
--format	-f	Output format: human, json. Default: human

# Create a new story skill
rai skill scaffold story-validate

# With lifecycle and ordering
rai skill scaffold story-validate --lifecycle story --after story-implement --before story-close

# Create in a skill set from a builtin
rai skill scaffold story-validate --set my-team --from-builtin

---

rai skill sync

Check skill freshness against installed package version. Reports which skills are current, outdated, or have conflicts.

Flag	Short	Description
--path	-p	Project path

rai skill sync
rai skill sync --path /path/to/project

Exit codes: 0 all current, 1 updates available.

---

rai skill set create

Create a new skill set from builtins. Copies all builtin skills to .raise/skills/<name>/ as a starting base for customization.

Argument	Description
NAME	Skill set name (required)

Flag	Short	Description
--empty		Create empty set (no builtins copied)
--format	-f	Output format: human, json. Default: human

# Create from builtins
rai skill set create my-team

# Create empty set
rai skill set create my-team --empty

---

rai skill set list

List all skill sets in .raise/skills/.

Flag	Short	Description
--format	-f	Output format: human, json. Default: human

rai skill set list

---

rai skill set diff

Compare a skill set against builtins. Shows which skills are added, modified, or unchanged.

Argument	Description
NAME	Skill set name to compare (required)

Flag	Short	Description
--format	-f	Output format: human, json. Default: human

rai skill set diff my-team

See also: rai init --skill-set