worktree-setup-hook
Post-checkout git hook for automatic worktree setup. Use when: (1) Setting up automatic configuration for new git worktrees, (2) Creating post-checkout hooks that detect new worktrees and run setup tasks, (3) Configuring worktrees to automatically copy env files and install dependencies
Setup Loop
Set up a Ralph execution loop in Beads by mapping a DevAgent plan into a Beads epic and tasks with the correct fields, dependencies, and routing labels. Use when: (1) Preparing Beads for Ralph autonomous execution, (2) Assigning correct routing labels and agents, (3) Ensuring dependencies and report tasks are wired, (4) Embedding plan references, quality gates, and context into Beads fields.
Revise Report Generation
Generates structured revise reports for Epics by aggregating task comments and learnings. Use when: (1) An Epic is completed or substantially progressed, (2) You want to consolidate "Revision Learning" comments from multiple tasks, (3) You need a traceability report linking tasks to commits.
PR Review Integration
Review pull requests by integrating GitHub operations with Linear issue tracking. Use when: (1) Validating PR changes against Linear issue requirements, (2) Checking if PR addresses all acceptance criteria from Linear issues, (3) Creating comprehensive PR reviews that link code changes to project requirements, (4) Identifying gaps between PR changes and issue requirements, or (5) Posting review findings to both GitHub PRs and Linear issues. Combines GitHub CLI operations with Linear MCP functions for end-to-end PR review workflows.
skill-creator
Guide for creating effective skills. This skill should be used when users want to create a new skill (or update an existing skill) that extends Claude's capabilities with specialized knowledge, workflows, or tool integrations.
storybook
Use Storybook to document UI states and design decisions as portable artifacts (stories + MDX docs) that engineers and QA can review. Use when: (1) exploring a component library interactively, (2) capturing canonical UI states for design guidance, (3) providing evidence and references in Beads task comments. This skill is tool-focused and does not assume Storybook is installed in the repo.
coderabbit-cli
Use CodeRabbit CLI to perform automated code review and iterative improvement in an AI agent workflow. Use when: (1) After generating non-trivial code (new features, refactors, algorithms), (2) Improving code quality, maintainability, or readability before submission, (3) Validating code changes against best practices, (4) Exploring unfamiliar languages, patterns, or domains, or (5) Creating a self-reviewing coding loop. Requires CodeRabbit CLI installed and authenticated. Not for trivial changes (typos, formatting-only) or rapid prototyping without quality constraints.
Quality Gate Detection
Detect and configure quality gate commands for Ralph's autonomous execution. Use when: (1) Analyzing a project to determine available test, lint, and build scripts, (2) Generatiing a task-specific verification checklist based on project reality. This skill enables Ralph to adapt verification to the specific project context.
Linear MCP Integration
Use Linear MCP server functions to interact with Linear issues, projects, teams, and comments. Use when: (1) Fetching issue requirements and acceptance criteria from Linear, (2) Validating PR changes against Linear issue requirements, (3) Creating or updating Linear issues and comments, (4) Checking issue status, labels, or relationships, (5) Listing issues by team, assignee, or project, or (6) Any Linear project management operation. Requires Linear MCP server configured and authenticated.
beads-integration
Use Beads CLI (`bd`) commands to manage tasks, status, and progress tracking for Ralph's autonomous execution. Use when: (1) Querying ready tasks with `bd ready`, (2) Updating task status (open → in_progress → closed), (3) Adding progress comments to tasks, (4) Managing task details (priority, design, notes, labels), (5) Handling task dependencies. This skill enables Ralph to use Beads' native memory and state management.
Issue Logging During Ralph Execution
Provides guidance for systematically logging issues during Ralph autonomous execution. Use when: (1) Any problem occurs during task execution, (2) Manual intervention is required, (3) Workflows don't work as expected, (4) Quality gates fail or require workarounds.
GitHub CLI Operations
Use GitHub CLI (gh) to interact with GitHub repositories, pull requests, issues, and workflows. Use when: (1) Reading PR details, diffs, or metadata, (2) Listing or filtering PRs and issues, (3) Creating PR comments or linking to issues, (4) Checking CI status or mergeability, (5) Extracting issue references from PR descriptions, or (6) Any GitHub repository operation via command line. Requires GitHub CLI installed and authenticated.
Agent Browser Integration
Use Vercel's agent-browser CLI for automated browser testing and UI verification. Use when: (1) browser-based quality gates are required, (2) verifying UI behavior in the browser, (3) gathering screenshots or DOM evidence during Ralph execution. This replaces Playwriter MCP usage.
ai-rules-cli
Use ai-rules CLI to manage and synchronize AI coding rules across multiple AI assistants (Cursor, Claude Code, GitHub Copilot, Opencode, etc.). Use when: (1) Setting up ai-rules in a new project, (2) Updating AI coding guidelines and best practices, (3) Generating platform-specific rule files from source, (4) Checking if generated files are in sync with source files, (5) Managing multi-agent rule consistency, or (6) Adding new rules or modifying existing ones. Requires ai-rules CLI installed. The ai-rules/ directory serves as the single source of truth for all AI coding guidelines.
create-slash-command
Create new slash commands for DevAgent workflows. Use when you need to create a new command file in .agents/commands/ and symlink it to .cursor/commands/ for Cursor IDE integration. This skill handles the complete command creation workflow including file generation, symlink creation, and structure validation.