pair programming

Q: How do I install pair programming?

Run npx skills add https://github.com/ruvnet/ruflo --skill pair-programming in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/pair-programming/ (personal) or .claude/skills/pair-programming/ (project).

by ruvnetCode Quality & Workflow

AI-assisted pair programming with multiple modes (driver$navigator$switch), real-time verification, quality monitoring, and comprehensive testing. Supports TDD, debugging, refactoring, and learning sessions. Features automatic role switching, continuous code review, security scanning, and performance optimization with truth-score verification.

Installs: 1.2K
Last 24h: —
Trending rank: —
Security: Not audited

Install

Works with every agent the skills CLI supports.

npx skills add https://github.com/ruvnet/ruflo --skill pair-programming

01
Install
Run the command in your project. The CLI asks which agents to install for.
02
Describe the task
Ask your agent for something this skill covers. It loads pair programming automatically when relevant.
03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.

SKILL.md

The instructions your agent reads when the skill is triggered.

Pair Programming

Collaborative AI pair programming with intelligent role management, real-time quality monitoring, and comprehensive development workflows.

What This Skill Does

This skill provides professional pair programming capabilities with AI assistance, supporting multiple collaboration modes, continuous verification, and integrated testing. It manages driver$navigator roles, performs real-time code review, tracks quality metrics, and ensures high standards through truth-score verification.

Key Capabilities:

Multiple Modes: Driver, Navigator, Switch, TDD, Review, Mentor, Debug
Real-Time Verification: Automatic quality scoring with rollback on failures
Role Management: Seamless switching between driver$navigator roles
Testing Integration: Auto-generate tests, track coverage, continuous testing
Code Review: Security scanning, performance analysis, best practice enforcement
Session Persistence: Auto-save, recovery, export, and sharing

How Claude Code Uses This

The CLI holds the session state; Claude Code reads it. There is no REPL to type into.

At the start of every turn run ruflo pair status --json. If active is false, this skill is dormant.
Follow mode and aiRole. As driver you write the code and the human reviews. As navigator you review and suggest and never edit unless asked. tdd, review, mentor and debug refine that behaviour as described below.
When switchDue is true, run ruflo pair switch, announce the swap, and continue in the new role.
Change mode mid-session with ruflo pair mode <mode>. The human can run the same commands from their shell.

State lives in .claude-flow/sessions/pair/current.json. ruflo pair end archives it to history.jsonl next to it.

Prerequisites

Required:

Ruflo CLI installed (npm install -g ruflo), which provides the ruflo pair command
Git repository (optional but recommended)

Recommended:

Testing framework (Jest, pytest, etc.)
Linter configured (ESLint, pylint, etc.)
Code formatter (Prettier, Black, etc.)

Quick Start

Basic Session

# Start simple pair programming
ruflo pair start

TDD Session

# Test-driven development
ruflo pair start \
  --mode tdd \
  --test-first \
  --coverage 90

Complete Guide

Session Control Commands

Starting Sessions

# Basic start
ruflo pair start

# Expert refactoring session
ruflo pair start \
  --agent senior-dev \
  --focus refactor \
  --verify \
  --threshold 0.98

# Debugging session
ruflo pair start \
  --agent debugger-expert \
  --focus debug \
  --review

# Learning session
ruflo pair start \
  --mode mentor \
  --pace slow \
  --examples

Session Management

# Check status
ruflo pair status

# View history
ruflo pair history

# Pause session
$pause [--reason <reason>]

# Resume session
$resume

# End session
ruflo pair end [--save] [--report]

Available Modes

Driver Mode

You write code while AI provides guidance.

ruflo pair start --mode driver

Your Responsibilities:

Write actual code
Implement solutions
Make immediate decisions
Handle syntax and structure

AI Navigator:

Strategic guidance
Spot potential issues
Suggest improvements
Real-time review
Track overall direction

Best For:

Learning new patterns
Implementing familiar features
Quick iterations
Hands-on debugging

Commands:

$suggest     - Get implementation suggestions
$review      - Request code review
$explain     - Ask for explanations
$optimize    - Request optimization ideas
$patterns    - Get pattern recommendations

Navigator Mode

AI writes code while you provide direction.

ruflo pair start --mode navigator

Your Responsibilities:

Provide high-level direction
Review generated code
Make architectural decisions
Ensure business requirements

AI Driver:

Write implementation code
Handle syntax details
Implement your guidance
Manage boilerplate
Execute refactoring

Best For:

Rapid prototyping
Boilerplate generation
Learning from AI patterns
Exploring solutions

Commands:

$implement   - Direct implementation
$refactor    - Request refactoring
$test        - Generate tests
$document    - Add documentation
$alternate   - See alternative approaches

Switch Mode

Automatically alternates roles at intervals.

# Default 10-minute intervals
ruflo pair start --mode switch

# 5-minute intervals (rapid)
ruflo pair start --mode switch --interval 5m

# 15-minute intervals (deep focus)
ruflo pair start --mode switch --interval 15m

Handoff Process:

30-second warning before switch
Current driver completes thought
Context summary generated
Roles swap smoothly
New driver continues

Best For:

Balanced collaboration
Knowledge sharing
Complex features
Extended sessions

Specialized Modes

TDD Mode - Test-Driven Development:

ruflo pair start \
  --mode tdd \
  --test-first \
  --coverage 100

Workflow: Write failing test → Implement → Refactor → Repeat

Review Mode - Continuous code review:

ruflo pair start \
  --mode review \
  --strict \
  --security

Features: Real-time feedback, security scanning, performance analysis

Mentor Mode - Learning-focused:

ruflo pair start \
  --mode mentor \
  --explain-all \
  --pace slow

Features: Detailed explanations, step-by-step guidance, pattern teaching

Debug Mode - Problem-solving:

ruflo pair start \
  --mode debug \
  --verbose \
  --trace

Features: Issue identification, root cause analysis, fix suggestions

In-Session Commands

Code Commands

$explain [--level basic|detailed|expert]
  Explain the current code or selection

$suggest [--type refactor|optimize|security|style]
  Get improvement suggestions

$implement <description>
  Request implementation (navigator mode)

$refactor [--pattern <pattern>] [--scope function|file|module]
  Refactor selected code

$optimize [--target speed|memory|both]
  Optimize code for performance

$document [--format jsdoc|markdown|inline]
  Add documentation to code

$comment [--verbose]
  Add inline comments

$pattern <pattern-name> [--example]
  Apply a design pattern

Testing Commands

$test [--watch] [--coverage] [--only <pattern>]
  Run test suite

$test-gen [--type unit|integration|e2e]
  Generate tests for current code

$coverage [--report html|json|terminal]
  Check test coverage

$mock <target> [--realistic]
  Generate mock data or functions

$test-watch [--on-save]
  Enable test watching

$snapshot [--update]
  Create test snapshots

Review Commands

$review [--scope current|file|changes] [--strict]
  Perform code review

$security [--deep] [--fix]
  Security analysis

$perf [--profile] [--suggestions]
  Performance analysis

$quality [--detailed]
  Check code quality metrics

$lint [--fix] [--config <config>]
  Run linters

$complexity [--threshold <value>]
  Analyze code complexity

Navigation Commands

$goto <file>[:line[:column]]
  Navigate to file or location

$find <pattern> [--regex] [--case-sensitive]
  Search in project

$recent [--limit <n>]
  Show recent files

$bookmark [add|list|goto|remove] [<name>]
  Manage bookmarks

$history [--limit <n>] [--filter <pattern>]
  Show command history

$tree [--depth <n>] [--filter <pattern>]
  Show project structure

Git Commands

$diff [--staged] [--file <file>]
  Show git diff

$commit [--message <msg>] [--amend]
  Commit with verification

$branch [create|switch|delete|list] [<name>]
  Branch operations

$stash [save|pop|list|apply] [<message>]
  Stash operations

$log [--oneline] [--limit <n>]
  View git log

$blame [<file>]
  Show git blame

AI Partner Commands

$agent [switch|info|config] [<agent-name>]
  Manage AI agent

$teach <preference>
  Teach the AI your preferences

$feedback [positive|negative] <message>
  Provide feedback to AI

$personality [professional|friendly|concise|verbose]
  Adjust AI personality

$expertise [add|remove|list] [<domain>]
  Set AI expertise focus

Metrics Commands

$metrics [--period today|session|week|all]
  Show session metrics

$score [--breakdown]
  Show quality scores

$productivity [--chart]
  Show productivity metrics

$leaderboard [--personal|team]
  Show improvement leaderboard

Role & Mode Commands

$switch [--immediate]
  Switch driver$navigator roles

$mode <type>
  Change mode (driver|navigator|switch|tdd|review|mentor|debug)

$role
  Show current role

$handoff
  Prepare role handoff

Command Shortcuts

Alias	Full Command
`$s`	`$suggest`
`$e`	`$explain`
`$t`	`$test`
`$r`	`$review`
`$c`	`$commit`
`$g`	`$goto`
`$f`	`$find`
`$h`	`$help`
`$sw`	`$switch`
`$st`	`$status`

Configuration

Basic Configuration

Create .claude-flow$pair-config.json:

{
  "pair": {
    "enabled": true,
    "defaultMode": "switch",
    "defaultAgent": "auto",
    "autoStart": false,
    "theme": "professional"
  }
}

Complete Configuration

{
  "pair": {
    "general": {
      "enabled": true,
      "defaultMode": "switch",
      "defaultAgent": "senior-dev",
      "language": "javascript",
      "timezone": "UTC"
    },

    "modes": {
      "driver": {
        "enabled": true,
        "suggestions": true,
        "realTimeReview": true,
        "autoComplete": false
      },
      "navigator": {
        "enabled": true,
        "codeGeneration": true,
        "explanations": true,
        "alternatives": true
      },
      "switch": {
        "enabled": true,
        "interval": "10m",
        "warning": "30s",
        "autoSwitch": true,
        "pauseOnIdle": true
      }
    },

    "verification": {
      "enabled": true,
      "threshold": 0.95,
      "autoRollback": true,
      "preCommitCheck": true,
      "continuousMonitoring": true,
      "blockOnFailure": true
    },

    "testing": {
      "enabled": true,
      "autoRun": true,
      "framework": "jest",
      "onSave": true,
      "coverage": {
        "enabled": true,
        "minimum": 80,
        "enforce": true,
        "reportFormat": "html"
      }
    },

    "review": {
      "enabled": true,
      "continuous": true,
      "preCommit": true,
      "security": true,
      "performance": true,
      "style": true,
      "complexity": {
        "maxComplexity": 10,
        "maxDepth": 4,
        "maxLines": 100
      }
    },

    "git": {
      "enabled": true,
      "autoCommit": false,
      "commitTemplate": "feat: {message}",
      "signCommits": false,
      "pushOnEnd": false,
      "branchProtection": true
    },

    "session": {
      "autoSave": true,
      "saveInterval": "5m",
      "maxDuration": "4h",
      "idleTimeout": "15m",
      "breakReminder": "45m",
      "metricsInterval": "1m"
    },

    "ai": {
      "model": "advanced",
      "temperature": 0.7,
      "maxTokens": 4000,
      "personality": "professional",
      "expertise": ["backend", "testing", "security"],
      "learningEnabled": true
    }
  }
}

Built-in Agents

{
  "agents": {
    "senior-dev": {
      "expertise": ["architecture", "patterns", "optimization"],
      "style": "thorough",
      "reviewLevel": "strict"
    },
    "tdd-specialist": {
      "expertise": ["testing", "mocks", "coverage"],
      "style": "test-first",
      "reviewLevel": "comprehensive"
    },
    "debugger-expert": {
      "expertise": ["debugging", "profiling", "tracing"],
      "style": "analytical",
      "reviewLevel": "focused"
    },
    "junior-dev": {
      "expertise": ["learning", "basics", "documentation"],
      "style": "questioning",
      "reviewLevel": "educational"
    }
  }
}

CLI Configuration

# Set configuration
ruflo pair config set defaultMode switch
ruflo pair config set verification.threshold 0.98

# Get configuration
ruflo pair config get
ruflo pair config get defaultMode

# Export/Import
ruflo pair config export > config.json
ruflo pair config import config.json

# Reset
ruflo pair config reset

Profile Management

Create reusable profiles:

# Create profile
ruflo pair profile create refactoring \
  --mode driver \
  --verify true \
  --threshold 0.98 \
  --focus refactor

# Use profile
ruflo pair start --profile refactoring

# List profiles
ruflo pair profile list

Profile configuration:

{
  "profiles": {
    "refactoring": {
      "mode": "driver",
      "verification": {
        "enabled": true,
        "threshold": 0.98
      },
      "focus": "refactor"
    },
    "debugging": {
      "mode": "navigator",
      "agent": "debugger-expert",
      "trace": true,
      "verbose": true
    },
    "learning": {
      "mode": "mentor",
      "pace": "slow",
      "explanations": "detailed",
      "examples": true
    }
  }
}

Real-World Examples

Example 1: Feature Implementation

Implementing user authentication with JWT tokens:

# Session setup
ruflo pair start \
  --mode switch \
  --agent senior-dev \
  --focus implement \
  --verify \
  --test

Session Flow:

👥 Starting pair programming for authentication feature...

[DRIVER: You - 10 minutes]
$explain JWT authentication flow
> AI explains JWT concepts and best practices

$suggest implementation approach
> AI suggests using middleware pattern with refresh tokens

# You write the basic auth middleware structure

[SWITCH TO NAVIGATOR]

[NAVIGATOR: AI - 10 minutes]
$implement JWT token generation with refresh tokens
> AI generates secure token implementation

$test-gen
> AI creates comprehensive test suite

[SWITCH TO DRIVER]

[DRIVER: You - 10 minutes]
# You refine the implementation
$review --security
> AI performs security review, suggests improvements

$commit --message "feat: JWT authentication with refresh tokens"
✅ Truth Score: 0.98 - Committed successfully

Example 2: Bug Fixing

Debugging a memory leak in Node.js:

# Session setup
ruflo pair start \
  --mode navigator \
  --agent debugger-expert \
  --focus debug \
  --trace

Session Flow:

👥 Starting debugging session...

$status
> Analyzing application for memory issues...

$perf --profile
> Memory usage growing: 150MB → 450MB over 10 minutes

$find "new EventEmitter" --regex
> Found 3 instances of EventEmitter creation

$inspect eventEmitters --deep
> Discovering listeners not being removed

$suggest fix for memory leak
> AI suggests: "Add removeListener in cleanup functions"

$implement cleanup functions for all event emitters
> AI generates proper cleanup code

$test
> Memory stable at 150MB ✅

$commit --message "fix: memory leak in event emitters"

Example 3: TDD Session

Building shopping cart with test-driven development:

# Session setup
ruflo pair start \
  --mode tdd \
  --agent tdd-specialist \
  --test-first

Session Flow:

👥 TDD Session: Shopping Cart Feature

[RED PHASE]
$test-gen "add item to cart"
> AI writes failing test:
  ✗ should add item to cart
  ✗ should update quantity for existing item
  ✗ should calculate total price

[GREEN PHASE]
$implement minimal cart functionality
> You write just enough code to pass tests

$test
> Tests passing: 3/3 ✅

[REFACTOR PHASE]
$refactor --pattern repository
> AI refactors to repository pattern

$test
> Tests still passing: 3/3 ✅

[NEXT CYCLE]
$test-gen "remove item from cart"
> AI writes new failing tests...

Example 4: Code Refactoring

Modernizing legacy code:

# Session setup
ruflo pair start \
  --mode driver \
  --focus refactor \
  --verify \
  --threshold 0.98

Session Flow:

👥 Refactoring Session: Modernizing UserService

$analyze UserService.js
> AI identifies:
  - Callback hell (5 levels deep)
  - No error handling
  - Tight coupling
  - No tests

$suggest refactoring plan
> AI suggests:
  1. Convert callbacks to async$await
  2. Add error boundaries
  3. Extract dependencies
  4. Add unit tests

$test-gen --before-refactor
> AI generates tests for current behavior

$refactor callbacks to async$await
# You refactor with AI guidance

$test
> All tests passing ✅

$review --compare
> AI shows before$after comparison
> Code complexity: 35 → 12
> Truth score: 0.99 ✅

$commit --message "refactor: modernize UserService with async$await"

Example 5: Performance Optimization

Optimizing slow React application:

# Session setup
ruflo pair start \
  --mode switch \
  --agent performance-expert \
  --focus optimize \
  --profile

Session Flow:

👥 Performance Optimization Session

$perf --profile
> React DevTools Profiler Results:
  - ProductList: 450ms render
  - CartSummary: 200ms render
  - Unnecessary re-renders: 15

$suggest optimizations for ProductList
> AI suggests:
  1. Add React.memo
  2. Use useMemo for expensive calculations
  3. Implement virtualization for long lists

$implement React.memo and useMemo
# You implement with AI guidance

$perf --profile
> ProductList: 45ms render (90% improvement!) ✅

$implement virtualization with react-window
> AI implements virtual scrolling

$perf --profile
> ProductList: 12ms render (97% improvement!) ✅
> FPS: 60 stable ✅

$commit --message "perf: optimize ProductList with memoization and virtualization"

Example 6: API Development

Building RESTful API with Express:

# Session setup
ruflo pair start \
  --mode navigator \
  --agent backend-expert \
  --focus implement \
  --test

Session Flow:

👥 API Development Session

$design REST API for blog platform
> AI designs endpoints:
  POST   $api$posts
  GET    $api$posts
  GET    $api$posts/:id
  PUT    $api$posts/:id
  DELETE $api$posts/:id

$implement CRUD endpoints with validation
> AI implements with Express + Joi validation

$test-gen --integration
> AI generates integration tests

$security --api
> AI adds:
  - Rate limiting
  - Input sanitization
  - JWT authentication
  - CORS configuration

$document --openapi
> AI generates OpenAPI documentation

$test --integration
> All endpoints tested: 15/15 ✅

Session Templates

Quick Start Templates

# Refactoring template
ruflo pair --template refactor
# Focus: Code improvement
# Verification: High (0.98)
# Testing: After each change
# Review: Continuous

# Feature template
ruflo pair --template feature
# Focus: Implementation
# Verification: Standard (0.95)
# Testing: On completion
# Review: Pre-commit

# Debug template
ruflo pair --template debug
# Focus: Problem solving
# Verification: Moderate (0.90)
# Testing: Regression tests
# Review: Root cause

# Learning template
ruflo pair --template learn
# Mode: Mentor
# Pace: Slow
# Explanations: Detailed
# Examples: Many

Session Management

Session Status

ruflo pair status

Output:

👥 Pair Programming Session
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Session ID: pair_1755021234567
Duration: 45 minutes
Status: Active

Partner: senior-dev
Current Role: DRIVER (you)
Mode: Switch (10m intervals)
Next Switch: in 3 minutes

📊 Metrics:
├── Truth Score: 0.982 ✅
├── Lines Changed: 234
├── Files Modified: 5
├── Tests Added: 12
├── Coverage: 87% ↑3%
└── Commits: 3

🎯 Focus: Implementation
📝 Current File: src$auth$login.js

Session History

ruflo pair history

Output:

📚 Session History
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

1. 2024-01-15 14:30 - 16:45 (2h 15m)
   Partner: expert-coder
   Focus: Refactoring
   Truth Score: 0.975
   Changes: +340 -125 lines

2. 2024-01-14 10:00 - 11:30 (1h 30m)
   Partner: tdd-specialist
   Focus: Testing
   Truth Score: 0.991
   Tests Added: 24

3. 2024-01-13 15:00 - 17:00 (2h)
   Partner: debugger-expert
   Focus: Bug Fixing
   Truth Score: 0.968
   Issues Fixed: 5

Session Persistence

# Save session
ruflo pair --save [--name <name>]

# Load session
ruflo pair --load <session-id>

# Export session
ruflo pair --export <session-id> [--format json|md]

# Generate report
ruflo pair --report <session-id>

Background Sessions

# Start in background
ruflo pair start --background

# Monitor background session
ruflo pair --monitor

# Attach to background session
ruflo pair --attach <session-id>

# End background session
ruflo pair end <session-id>

Advanced Features

Custom Commands

Define in configuration:

{
  "customCommands": {
    "tdd": "$test-gen && $test --watch",
    "full-review": "$lint --fix && $test && $review --strict",
    "quick-fix": "$suggest --type fix && $implement && $test"
  }
}

Use custom commands:

$custom tdd
$custom full-review

Command Chaining

$test && $commit && $push
$lint --fix && $test && $review --strict

Session Recording

# Start with recording
ruflo pair start --record

# Replay session
ruflo pair --replay <session-id>

# Session analytics
ruflo pair --analytics <session-id>

Integration Options

With Git:

ruflo pair start --git --auto-commit

With CI/CD:

ruflo pair start --ci --non-interactive

With IDE:

ruflo pair start --ide vscode

Best Practices

Session Practices

Clear Goals - Define session objectives upfront
Appropriate Mode - Choose based on task type
Enable Verification - For critical code paths
Regular Testing - Maintain quality continuously
Session Notes - Document important decisions
Regular Breaks - Take breaks every 45-60 minutes

Code Practices

Test Early - Run tests after each change
Verify Before Commit - Check truth scores
Review Security - Always for sensitive code
Profile Performance - Use $perf for optimization
Save Sessions - For complex work
Learn from AI - Ask questions frequently

Mode Selection

Driver Mode: When learning, controlling implementation
Navigator Mode: For rapid prototyping, generation
Switch Mode: Long sessions, balanced collaboration
TDD Mode: Building with tests
Review Mode: Quality focus
Mentor Mode: Learning priority
Debug Mode: Fixing issues

Troubleshooting

Session Won't Start

Check agent availability
Verify configuration file syntax
Ensure clean workspace
Review log files

Session Disconnected

Use --recover to restore
Check network connection
Verify background processes
Review auto-save files

Poor Performance

Reduce verification threshold
Disable continuous testing
Check system resources
Use lighter AI model

Configuration Issues

Validate JSON syntax
Check file permissions
Review priority order (CLI > env > project > user > global)
Run ruflo pair config validate

Quality Metrics

Truth Score Thresholds

Error:   < 0.90 ❌
Warning: 0.90 - 0.95 ⚠️
Good:    0.95 - 0.98 ✅
Excellent: > 0.98 🌟

Coverage Thresholds

Error:   < 70% ❌
Warning: 70% - 80% ⚠️
Good:    80% - 90% ✅
Excellent: > 90% 🌟

Complexity Thresholds

Error:   > 15 ❌
Warning: 10 - 15 ⚠️
Good:    5 - 10 ✅
Excellent: < 5 🌟

Environment Variables

Override configuration via environment:

export CLAUDE_PAIR_MODE=driver
export CLAUDE_PAIR_VERIFY=true
export CLAUDE_PAIR_THRESHOLD=0.98
export CLAUDE_PAIR_AGENT=senior-dev
export CLAUDE_PAIR_AUTO_TEST=true

Command History

Navigate history:

↑/↓ - Navigate through command history
Ctrl+R - Search command history
!! - Repeat last command
!<n> - Run command n from history

Keyboard Shortcuts (Configurable)

Default shortcuts:

{
  "shortcuts": {
    "switch": "ctrl+shift+s",
    "suggest": "ctrl+space",
    "review": "ctrl+r",
    "test": "ctrl+t"
  }
}

Related Commands

ruflo pair --help - Show help
ruflo pair config - Manage configuration
ruflo pair profile - Manage profiles
ruflo pair templates - List templates
ruflo pair agents - List available agents

FAQ

What does the pair programming skill do?

How do I install pair programming?

Run npx skills add https://github.com/ruvnet/ruflo --skill pair-programming in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/pair-programming/ (personal) or .claude/skills/pair-programming/ (project).

Which AI agents can use pair programming?

Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.

Is pair programming safe to install?

No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.

Who maintains pair programming?

It is published by ruvnet in ruvnet/ruflo. It has 1,171 recorded installs.

More from ruvnet/ruflo

View all →

ruflo

ruvnet/ruflo

Open the skill to read its SKILL.md instructions.

4K installs

swarm-orchestration

ruvnet/ruflo

Multi-agent swarm coordination for complex tasks. Uses hierarchical topology with specialized agents to break down and execute complex work across multiple files and modules. Use when: 3+ files need changes, new feature implementation, cross-module refactoring, API changes with tests, security-related changes, performance optimization across codebase, database schema changes. Skip when: single file edits, simple bug fixes (1-2 lines), documentation updates, configuration changes, quick exploration.

Code Quality & Workflow2.1K installs

agent-arch-system-design

ruvnet/ruflo

Agent skill for arch-system-design - invoke with $agent-arch-system-design

1.4K installs

agent-workflow

ruvnet/ruflo

Agent skill for workflow - invoke with $agent-workflow

Productivity & Automation1.4K installs

security-audit

ruvnet/ruflo

Comprehensive security scanning and vulnerability detection. Includes input validation, path traversal prevention, CVE detection, and secure coding pattern enforcement. Use when: authentication implementation, authorization logic, payment processing, user data handling, API endpoint creation, file upload handling, database queries, external API integration. Skip when: read-only operations on public data, internal development tooling, static documentation, styling changes.

Security1.4K installs

github-project-management

ruvnet/ruflo

Comprehensive GitHub project management with swarm-coordinated issue tracking, project board automation, and sprint planning

Code Quality & Workflow1.4K installs

Popular code quality & workflow skills

View category →

grill-me

mattpocock/skills

A relentless interview to sharpen a plan or design.

Code Quality & Workflow1.4M installs

improve-codebase-architecture

mattpocock/skills

Scan a codebase for deepening opportunities, present them as a visual HTML report, then grill through whichever one you pick.

Code Quality & Workflow1.2M installs

handoff

mattpocock/skills

Compact the current conversation into a handoff document for another agent to pick up.

Code Quality & Workflow1.1M installs

domain-modeling

mattpocock/skills

Build and sharpen a project's domain model. Use when discussing codebase terminology, writing or editing a GLOSSARY.md, or recording or editing an ADR.

Code Quality & Workflow890.6K installs

codebase-design

mattpocock/skills

Shared vocabulary for designing deep modules. Use when the user wants to design or improve a module's interface, find deepening opportunities, decide where a seam goes, make code more testable or AI-navigable, or when another skill needs the deep-module vocabulary.

Code Quality & Workflow863.8K installs

diagnosing-bugs

mattpocock/skills

Diagnosis loop for hard bugs and performance regressions. Use when the user says "diagnose"/"debug this", or reports something broken/throwing/failing/slow.

Code Quality & Workflow848.4K installs

pair programming

Install

Install

Describe the task

Review the result

SKILL.md

Pair Programming

What This Skill Does

How Claude Code Uses This

Prerequisites

Quick Start

Basic Session

TDD Session

Complete Guide

Session Control Commands

Starting Sessions

Session Management

Available Modes

Driver Mode

Navigator Mode

Switch Mode

Specialized Modes

In-Session Commands

Code Commands

Testing Commands

Review Commands

Navigation Commands

Git Commands

AI Partner Commands

Metrics Commands

Role & Mode Commands

Command Shortcuts

Configuration

Basic Configuration

Complete Configuration

Built-in Agents

CLI Configuration

Profile Management

Real-World Examples

Example 1: Feature Implementation

Example 2: Bug Fixing

Example 3: TDD Session

Example 4: Code Refactoring

Example 5: Performance Optimization

Example 6: API Development

Session Templates

Quick Start Templates

Session Management

Session Status

Session History

Session Persistence

Background Sessions

Advanced Features

Custom Commands

Command Chaining

Session Recording

Integration Options

Best Practices

Session Practices

Code Practices

Mode Selection

Troubleshooting

Session Won't Start

Session Disconnected

Poor Performance

Configuration Issues

Quality Metrics

Truth Score Thresholds

Coverage Thresholds

Complexity Thresholds

Environment Variables

Command History

Keyboard Shortcuts (Configurable)

Related Commands

FAQ

More from ruvnet/ruflo

Popular code quality & workflow skills