Skills Catalog

RaiSE ships with 53 public skills organized by lifecycle (plus 2 internal test skills). Each skill is a structured workflow defined in a SKILL.md file that your AI partner follows step by step.

Invoke any skill by typing its name (e.g., /rai-story-design) in your AI assistant. See Skills concept for how skills work, or Create a Skill to build your own.

Epic Lifecycle

Epics are bodies of work spanning 3–10 stories. See Your First Story for context.

Skill	Description
/rai-epic-start	Initialize epic directory, brief, and tracker entry.
/rai-epic-design	Design epic scope, stories, and architecture.
/rai-epic-ux-design	Define workflows, surfaces, and trust boundaries for user-facing epics.
/rai-epic-plan	Sequence stories into milestones and dependencies.
/rai-epic-docs	Generate architecture docs and publish to Confluence.
/rai-epic-journal	Write a narrative epic journal entry for the team.
/rai-epic-close	Close epic with retrospective, push, and merge request.

Story Lifecycle

Stories are the unit of deliverable work. Every story follows the same six phases.

Skill	Description
/rai-story-start	Create story branch and scope commit.
/rai-story-design	Create lean story specification for human review and AI alignment.
/rai-story-plan	Decompose story into atomic TDD tasks with verification criteria.
/rai-story-implement	Execute plan tasks with RED-GREEN-REFACTOR and validation gates.
/rai-story-review	Extract learnings and persist patterns from completed story.
/rai-story-close	Merge story branch and update tracking.

Bugfix Lifecycle

Bugs follow a structured pipeline with root cause analysis and post-incident review. See Bugfix Lifecycle.

Skill	Description
/rai-bugfix-start	Initialize bug branch, reproduce, and create scope artifact.
/rai-bugfix-triage	Classify bug in 4 ODC-inspired dimensions.
/rai-bugfix-analyse	Root cause analysis using 5 Whys, Ishikawa, or Gemba.
/rai-bugfix-plan	Decompose fix into atomic TDD tasks.
/rai-bugfix-fix	Execute fix tasks with TDD and validation gates.
/rai-bugfix-review	Retrospective, pattern extraction, and process improvement.
/rai-bugfix-close	Push branch, create MR, verify artifacts complete.
/rai-bugfix-pir	Post-Incident Review for severity 1–2 bugs.

Session Lifecycle

Sessions are the daily work container. They provide continuity across conversations.

Skill	Description
/rai-session-start	Load context bundle and propose session focus.
/rai-session-diary	Write a narrative session diary entry to Confluence.
/rai-session-close	Capture session outcomes and update memory.

Project Setup

Skills for initializing and configuring a RaiSE project. See Setting Up.

Skill	Description
/rai-welcome	Onboard a developer to RaiSE interactively.
/rai-project-create	Set up governance for a new (greenfield) project.
/rai-project-onboard	Discover conventions and set up governance for an existing codebase.
/rai-onboard-repo	Connect a repository to the RaiSE server.
/rai-discover	Scan codebase, extract symbols, and build knowledge graph.
/rai-doctor	Run self-diagnostics and guide fixes.

Quality and Review

Skills for verifying code quality and architectural fitness.

Skill	Description
/rai-architecture-review	Evaluate design proportionality using Beck's four rules.
/rai-quality-review	Audit code for semantic bugs, type lies, and test muda.
/rai-code-audit	Audit modules against code standards for naming, idioms, and API design.
/rai-sonarqube	Run SonarQube local static analysis (SAST).

Infrastructure

Skills for managing integrations, worktrees, and releases.

Skill	Description
/rai-backlog-setup	Configure Jira for all RaiSE skills in one session.
/rai-docs-setup	Configure the docs adapter (Confluence).
/rai-docs-setup-advanced	Add Confluence spaces and set per-artifact parent paths.
/rai-docs-update	Sync module docs with knowledge graph.
/rai-framework-sync	Sync governance files across locations.
/rai-mcp-add	Register an MCP server conversationally.
/rai-mcp-remove	Remove an MCP server with dependency checking.
/rai-mcp-status	Check health of registered MCP servers.
/rai-skill-create	Create a new skill through guided conversation.
/rai-skillset-manage	Manage skill sets — create, compare, or customize.
/rai-worktree-open	Open a new git worktree with full environment setup.
/rai-worktree-close	Close a git worktree and suggest MR creation.
/rai-mr-create	Run full gate suite, push, and create merge request.
/rai-publish	Run release workflow with quality gates and PyPI publishing.
/rai-mission-close	Close a mission with reflective retrospective.

Research and Design

Skills for analysis and design work outside the standard lifecycles.

Skill	Description
/rai-research	Conduct research with triangulated evidence to inform decisions.
/rai-problem-shape	Shape a vague idea into a problem brief before epic design.
/rai-interaction-blueprint	Design the developer interaction experience for agentic features.
/rai-debug	Find root cause using 5 Whys, Ishikawa, or Gemba walk.