Skip to content

Base Plugin Reference

The rp1-base plugin provides foundation workflows for understanding your project, generating documentation, doing deep analysis, and keeping rp1 up to date.

Skills

Skill Description
knowledge-build Generate knowledge base using parallel map-reduce architecture
deep-research Autonomous research on codebases and technical topics
project-birds-eye-view Generate comprehensive project overview with diagrams
write-content Interactive technical content creation assistant
strategize Holistic strategic analysis with trade-off recommendations
socratic-duel Direct two-agent debate recorded in a separate .rp1/work/debates/ artifact
socratic-duel-run Launcher that delegates all debate turns while it coordinates and reports
analyse-security Comprehensive security validation and vulnerability scanning
fix-mermaid Validate and repair Mermaid diagrams in markdown files
self-update Update rp1 to the latest version

Advanced Agent Tools

These references expose machine-facing commands. Use them when debugging or automating rp1; normal project setup and workflow use do not require them.

Tool Description
work-search Search project-scoped markdown work artifacts through rp1 agent-tools work-search

Skill Categories

Knowledge Management

Build and load the knowledge base that powers context-aware agents.

  • knowledge-build: Analyzes your codebase and generates documentation in .rp1/context/

Research

Autonomous investigation of codebases and technical topics.

  • deep-research: Map-reduce architecture with explorer agents for thorough investigation. Supports single-project analysis, multi-project comparison, and technical investigations with web search.

Documentation

Generate comprehensive documentation for onboarding and communication.

Analysis

Deep analysis for strategy and security.

  • strategize: Provides strategic recommendations balancing cost, quality, and complexity
  • socratic-duel: Runs a bounded, evidence-driven two-agent debate against a read-only Markdown source and records turns in a separate debate artifact
  • socratic-duel-run: Launches two debate participants while the launcher only coordinates and reports
  • analyse-security: Comprehensive security validation and vulnerability detection

Validation

Repair and validate documentation artifacts.

  • fix-mermaid: Validates Mermaid diagram syntax and auto-repairs common errors (up to 3 attempts per diagram). Unfixable diagrams get placeholder comments.

Maintenance

Keep rp1 up to date.

  • self-update: Updates rp1 using your package manager (Homebrew, Scoop) or provides manual instructions for other installations.

Invocation Patterns

Base workflows use the same names on every host:

Host Example
Claude Code /knowledge-build
OpenCode /rp1-base-knowledge-build
Codex $rp1-base-knowledge-build

Quick Start

After installation, generate a knowledge base:

/knowledge-build

/rp1-base-knowledge-build

You can also type /skills to browse all available skills — rp1 skills are prefixed with rp1- (e.g., /rp1-base-knowledge-build, /rp1-base-strategize).

$rp1-base-knowledge-build

This creates .rp1/context/ with documentation files that other skills use for context-aware execution.