octo

Smart router - Single entry point with natural language intent detection

"Start a creative thought partner brainstorming session"

Activate destructive command warnings for the session

OpenClaw instance administration — manage hosts across macOS, Ubuntu/Debian, Docker, OCI, and Proxmox

Show cost breakdown by provider and workflow for the current session

"AI Debate Hub - Structured four-way debates between Claude, Sonnet, Gemini, and Codex"

Systematic debugging with methodical problem investigation

Generate slide deck presentations from briefs or research

"Definition phase - Clarify and scope problems with multi-AI consensus"

"Delivery phase - Review, validate, and test with multi-AI quality assurance"

"Design UI/UX systems with style guides, palettes, typography, and component specs"

"Switch to Dev Work mode - optimized for software development"

"Development phase - Build solutions with multi-AI implementation and quality gates"

"Discovery phase - Multi-AI research and exploration"

Document delivery with export to PPTX, DOCX, PDF formats

Environment diagnostics — check providers, auth, config, hooks, scheduler, and more

Full Double Diamond workflow - Research → Define → Develop → Deliver

"Design System & Product Reverse-Engineering - Extract tokens, components, architecture, and PRDs from codebases or live products"

"Dark Factory Mode - Spec-in, software-out autonomous pipeline"

Restrict file edits to a specific directory boundary

Activate both careful mode and freeze mode together

Query past workflow results — filter by workflow type, date, or provider

"Switch to Knowledge Work mode (or toggle with off)"

Execute tasks in loops with conditions, iterative improvements until goals are met

"Generate an optimized prompt for any task using meta-prompting techniques"

Configure AI provider models for Claude Octopus workflows

Force multi-provider parallel execution for any task - manual override mode

"Team of Teams - Decompose compound tasks across independent claude instances"

"Run content analysis pipeline on URL(s) to extract patterns and create anatomy guides"

"Intelligent plan builder - creates strategic execution plans (doesn't execute). Use /octo:embrace to execute plans."

Score an existing PRD against the 100-point AI-optimization framework

Write an AI-optimized PRD using multi-AI orchestration and 100-point scoring framework

Quick execution mode for ad-hoc tasks without full workflow overhead

Deep research with multi-source synthesis and comprehensive analysis

Resume a previous agent by ID — continue an interrupted task where it left off

Generate engineering retrospectives from git history with trends and team analysis

Expert multi-LLM code review with inline PR comments — competes with CC Code Review

"Manage scheduled workflow jobs (add via wizard, dashboard, list, remove, enable, disable, logs)"

"Manage the scheduled workflow runner daemon (start/stop/status)"

Security audit with OWASP compliance and vulnerability detection

GitHub-aware work monitor - triages issues, PRs, and CI failures

Interactive setup wizard — install providers, configure auth, RTK, token optimization

"NLSpec authoring - Structured specification from multi-AI research"

"Two-stage review: spec compliance then code quality"

Test-driven development with red-green-refactor discipline

Remove freeze mode edit restriction

"[Legacy] Redirects to /octo:auto — the smart router"

Smart router - Single entry point with natural language intent detection

[Legacy] Redirects to /octo:auto — the smart router

Write an AI-optimized PRD using multi-AI orchestration and 100-point scoring framework

Run content analysis pipeline on URL(s) to extract patterns and create anatomy guides

Start a creative thought partner brainstorming session

Generate an optimized prompt for any task using meta-prompting techniques

Score an existing PRD against the 100-point AI-optimization framework

Interactive setup wizard — install providers, configure auth, RTK, token optimization

Switch to Knowledge Work mode (or toggle with off)

Switch to Dev Work mode - optimized for software development

Enhanced multi-LLM review with inline PR comments — escalation path beyond Claude-native /review

Enhanced multi-LLM or adversarial security audit — escalation path beyond Claude-native /security-review

Systematic debugging with methodical problem investigation

Test-driven development with red-green-refactor discipline

Execute tasks in loops with conditions, iterative improvements until goals are met

Document delivery with export to PPTX, DOCX, PDF formats

Full Double Diamond workflow - Research → Define → Develop → Deliver

Discovery phase - Multi-AI research and exploration

Definition phase - Clarify and scope problems with multi-AI consensus

Development phase - Build solutions with multi-AI implementation and quality gates

Delivery phase - Review, validate, and test with multi-AI quality assurance

Force multi-provider parallel execution for any task - manual override mode

Intelligent plan builder - creates strategic execution plans (doesn't execute). Use /octo:embrace to execute plans.

Quick execution mode for ad-hoc tasks without full workflow overhead

Design System & Product Reverse-Engineering - Extract tokens, components, architecture, and PRDs from codebases or live products

Configure AI provider models for Claude Octopus workflows

Generate slide deck presentations from briefs or research

Manage the scheduled workflow runner daemon (start/stop/status)

Manage scheduled workflow jobs (add via wizard, dashboard, list, remove, enable, disable, logs)

NLSpec authoring - Structured specification from multi-AI research

Team of Teams - Decompose compound tasks across independent claude instances

GitHub-aware work monitor - triages issues, PRs, and CI failures

OpenClaw instance administration — manage hosts across macOS, Ubuntu/Debian, Docker, OCI, and Proxmox

Environment diagnostics with interactive fixes — providers, auth, RTK, hooks, token optimization

Dark Factory Mode - Spec-in, software-out autonomous pipeline

Two-stage review: spec compliance then code quality

Design UI/UX systems with style guides, palettes, typography, and component specs

AI Debate Hub - Structured four-way debates between Claude, Sonnet, Gemini, and Codex

Deep research with multi-source synthesis and comprehensive analysis

Resume a previous agent by ID — continue an interrupted task where it left off

Activate destructive command warnings for the session

Restrict file edits to a specific directory boundary

Activate both careful mode and freeze mode together

Remove freeze mode edit restriction

Show cost breakdown by provider and workflow for the current session

Generate engineering retrospectives from git history with trends and team analysis

Query past workflow results — filter by workflow type, date, or provider

Toggle discipline mode — auto-invoke verification, brainstorming-before-coding, and review checks

Expert research synthesizer specializing in literature review, multi-source synthesis, thematic analysis, and research gap identification. Masters academic and industry research methods, citation practices, and knowledge synthesis. Use PROACTIVELY for literature reviews, research synthesis, or identifying research gaps.

Expert security auditor specializing in DevSecOps, comprehensive cybersecurity, and compliance frameworks. Masters vulnerability assessment, threat modeling, secure authentication (OAuth2/OIDC), OWASP standards, cloud security, and security automation. Handles DevSecOps integration, compliance (GDPR/HIPAA/SOC2), and incident response. Use PROACTIVELY for security audits, DevSecOps, or compliance implementation.

Expert strategy analyst specializing in market analysis, competitive intelligence, business case development, and strategic recommendations. Masters frameworks like Porter's Five Forces, SWOT, and business model canvas. Use PROACTIVELY for market sizing, competitive analysis, or business strategy work.

Master TDD orchestrator specializing in red-green-refactor discipline, multi-agent workflow coordination, and comprehensive test-driven development practices. Enforces TDD best practices across teams with AI-assisted testing and modern frameworks. Use PROACTIVELY for TDD implementation and governance.

Master AI-powered test automation with modern frameworks, self-healing tests, and comprehensive quality engineering. Build scalable testing strategies with advanced CI/CD integration. Use PROACTIVELY for testing automation or quality assurance.

Master TypeScript with advanced types, generics, and strict type safety. Handles complex type systems, decorators, and enterprise-grade patterns. Use PROACTIVELY for TypeScript architecture, type inference optimization, or advanced typing patterns.

Design UI/UX systems with style guides, color palettes, typography, and component specs. Bridges user research and frontend implementation using BM25 design intelligence. Use PROACTIVELY when designing interfaces or creating design systems.

Expert UX researcher specializing in user research synthesis, journey mapping, persona creation, and usability evaluation. Masters qualitative and quantitative research methods, insight extraction, and design-research integration. Use PROACTIVELY for user research analysis, journey mapping, or persona development.

General code quality critique principles

Critique principles for maintainable, readable code

Critique principles for high-performance code

Critique principles for secure code development

System architecture and design skill leveraging the backend-architect persona. Use for API design, microservices patterns, and distributed systems planning.

Expert code review skill leveraging the code-reviewer persona. Use when you need comprehensive code quality assessment, security vulnerability detection, or architecture review.

Comprehensive security auditing skill leveraging the security-auditor persona. Use for vulnerability scanning, OWASP compliance checks, and security reviews.

Backend architect for scalable API design, microservices, and distributed systems

Cloud architect for AWS/Azure/GCP infrastructure, IaC, FinOps, and multi-cloud strategies

Code review expert for quality analysis, security vulnerabilities, and production reliability

Database architect for data modeling, technology selection, schema design, and migration planning

Debugging specialist for errors, test failures, and unexpected behavior

Technical documentation architect for comprehensive system docs and architecture guides

Frontend developer for React, Next.js, responsive layouts, and accessible UI components

Performance engineer for optimization, observability, and scalable system performance

Security auditor for DevSecOps, OWASP compliance, vulnerability assessment, and threat modeling

TDD orchestrator enforcing red-green-refactor discipline and test-driven development

Expert academic writer specializing in research papers, grant proposals, abstracts, and scholarly communication. Masters academic writing conventions, peer review preparation, and research dissemination. Use PROACTIVELY for paper drafting, grant writing, or academic communication.

Build production-ready LLM applications, advanced RAG systems, and intelligent agents. Implements vector search, multimodal AI, agent orchestration, and enterprise AI integrations. Use PROACTIVELY for LLM features, chatbots, AI agents, or AI-powered applications.

Expert backend architect specializing in scalable API design, microservices architecture, and distributed systems. Masters REST/GraphQL/gRPC APIs, event-driven architectures, service mesh patterns, and modern backend frameworks. Handles service boundary definition, inter-service communication, resilience patterns, and observability. Use PROACTIVELY when creating new backend services or APIs.

Master modern business analysis with AI-powered analytics, real-time dashboards, and data-driven insights. Build comprehensive KPI frameworks, predictive models, and strategic recommendations. Use PROACTIVELY for business intelligence or strategic analysis.

Expert cloud architect specializing in AWS/Azure/GCP multi-cloud infrastructure design, advanced IaC (Terraform/OpenTofu/CDK), FinOps cost optimization, and modern architectural patterns. Masters serverless, microservices, security, compliance, and disaster recovery. Use PROACTIVELY for cloud architecture, cost optimization, migration planning, or multi-cloud strategies.

Elite code review expert specializing in modern AI-powered code analysis, security vulnerabilities, performance optimization, and production reliability. Masters static analysis tools, security scanning, and configuration review with 2024/2025 best practices. Use PROACTIVELY for code quality assurance.

Elite AI context engineering specialist mastering dynamic context management, vector databases, knowledge graphs, and intelligent memory systems. Orchestrates context across multi-agent workflows, enterprise AI systems, and long-running projects with 2024/2025 best practices. Use PROACTIVELY for complex AI orchestration.

Expert database architect specializing in data layer design from scratch, technology selection, schema modeling, and scalable database architectures. Masters SQL/NoSQL/TimeSeries database selection, normalization strategies, migration planning, and performance-first design. Handles both greenfield architectures and re-architecture of existing systems. Use PROACTIVELY for database architecture, technology selection, or data modeling decisions.

Debugging specialist for errors, test failures, and unexpected behavior. Use proactively when encountering any issues.

Expert deployment engineer specializing in modern CI/CD pipelines, GitOps workflows, and advanced deployment automation. Masters GitHub Actions, ArgoCD/Flux, progressive delivery, container security, and platform engineering. Handles zero-downtime deployments, security scanning, and developer experience optimization. Use PROACTIVELY for CI/CD design, GitOps implementation, or deployment automation.

Expert DevOps troubleshooter specializing in rapid incident response, advanced debugging, and modern observability. Masters log analysis, distributed tracing, Kubernetes debugging, performance optimization, and root cause analysis. Handles production outages, system reliability, and preventive monitoring. Use PROACTIVELY for debugging, incident response, or system troubleshooting.

Creates comprehensive technical documentation from existing codebases. Analyzes architecture, design patterns, and implementation details to produce long-form technical manuals and ebooks. Use PROACTIVELY for system documentation, architecture guides, or technical deep-dives.

Expert executive communicator specializing in board presentations, stakeholder reports, and C-suite communication. Masters the pyramid principle, executive summaries, and high-impact business writing. Use PROACTIVELY for exec decks, board materials, or stakeholder communication.

Expert finance analyst specializing in financial modeling, budgeting, forecasting, ROI/NPV analysis, cash flow management, unit economics, and pricing strategy. Masters spreadsheet-driven analysis and strategic finance. Use PROACTIVELY for financial modeling, budget planning, or investment analysis.

Build React components, implement responsive layouts, and handle client-side state management. Masters React 19, Next.js 15, and modern frontend architecture. Optimizes performance and ensures accessibility. Use PROACTIVELY when creating UI components or fixing frontend issues.

Master modern GraphQL with federation, performance optimization, and enterprise security. Build scalable schemas, implement advanced caching, and design real-time systems. Use PROACTIVELY for GraphQL architecture or performance optimization.

Expert SRE incident responder specializing in rapid problem resolution, modern observability, and comprehensive incident management. Masters incident command, blameless post-mortems, error budget management, and system reliability patterns. Handles critical outages, communication strategies, and continuous improvement. Use IMMEDIATELY for production incidents or SRE practices.

Expert compliance advisor specializing in GDPR, CCPA, HIPAA, SOC 2, privacy policy review, contract analysis, and regulatory risk assessment. Masters data protection frameworks and compliance program design. Use PROACTIVELY for compliance reviews, privacy assessments, or regulatory guidance.

Expert marketing strategist specializing in campaign planning, growth funnels, SEO strategy, content marketing, brand positioning, and attribution modeling. Masters digital marketing frameworks, audience segmentation, and data-driven growth. Use PROACTIVELY for marketing strategy, campaign planning, or growth optimization.

Create Mermaid diagrams for flowcharts, sequences, ERDs, and architectures. Masters syntax for all diagram types and styling. Use PROACTIVELY for visual documentation, system diagrams, or process flows.

Expert system administrator specializing in OpenClaw instance management across macOS, Ubuntu/Debian, Docker, Oracle OCI, and Proxmox. Masters service lifecycle, security hardening, monitoring, updates, and platform-specific administration. Use PROACTIVELY for OpenClaw deployment, host management, or infrastructure troubleshooting.

Expert performance engineer specializing in modern observability, application optimization, and scalable system performance. Masters OpenTelemetry, distributed tracing, load testing, multi-tier caching, Core Web Vitals, and performance monitoring. Handles end-to-end optimization, real user monitoring, and scalability patterns. Use PROACTIVELY for performance optimization, observability, or scalability challenges.

Expert product writer specializing in AI-optimized PRDs, user stories, and acceptance criteria. Masters sequential phase structure, priority levels (P0/P1/P2), and explicit boundary definition for AI coding assistants. Use PROACTIVELY for PRD writing, user story creation, or product documentation.

Master Python 3.12+ with modern features, async programming, performance optimization, and production-ready practices. Expert in the latest Python ecosystem including uv, ruff, pydantic, and FastAPI. Use PROACTIVELY for Python development, optimization, or advanced Python patterns.

Multi-AI requirements scoping using Codex and Gemini CLIs (Double Diamond Define phase). Use when: AUTOMATICALLY ACTIVATE when user requests clarification or scoping:. "define the requirements for X". "clarify the scope of Y"

Multi-AI validation, scoring, and review using Codex and Gemini CLIs (Double Diamond Deliver phase). Use when: AUTOMATICALLY ACTIVATE when user requests validation, scoring, or review:. "review X" or "validate Y" or "test Z". "score this", "quality check", "validate before shipping"

Multi-AI implementation using Codex and Gemini CLIs (Double Diamond Develop phase). Use when: AUTOMATICALLY ACTIVATE when user requests building or implementation:. "build X" or "implement Y" or "create Z". "develop a feature for X"

Multi-AI research using Codex and Gemini CLIs (Double Diamond Discover phase). Use when: AUTOMATICALLY ACTIVATE when user requests research or exploration:. "research X" or "explore Y" or "investigate Z". "what are the options for X" or "what are my choices for Y"

NLSpec authoring — structured specification from multi-AI research

System architecture and API design with multi-AI consensus

Quick execution for ad-hoc tasks without workflow overhead. Use when: Use this skill when user says "quick fix", "ad-hoc task", or explicitly. requests fast execution without full workflow overhead.

Audit codebases for quality, consistency, and broken patterns — use for pre-release or tech debt review. Use when: AUTOMATICALLY ACTIVATE when user requests auditing:. "audit and check the entire app". "audit X for Y" or "check for broken features"

OpenClaw instance administration — manage hosts across macOS, Ubuntu/Debian, Docker, OCI, and Proxmox. Use when: AUTOMATICALLY ACTIVATE when user asks about:. "manage openclaw" or "openclaw status" or "openclaw health". "update openclaw" or "upgrade openclaw" or "openclaw doctor"

Expert multi-AI code review with quality and security analysis

Extract patterns and anatomy from URLs — use to reverse-engineer content strategies from live pages. Use when: Use PROACTIVELY when user wants to:. "analyze this article", "analyze this content". "deconstruct this content", "break down this post"

Auto-detect work context (Dev vs Knowledge) for workflow tailoring

GitHub Copilot CLI as optional zero-cost provider via copilot -p programmatic mode. Use when: AUTOMATICALLY ACTIVATE when user says:. "copilot provider" or "add copilot" or "github copilot" or "use copilot"

Project remaining workflow cost from per-phase averages — warns on budget ceiling overruns. Use when: AUTOMATICALLY ACTIVATE when user asks about workflow costs:. "cost projection", "estimate remaining cost". "budget forecast", "how much will this cost"

Trace codepaths in diffs, map against tests, auto-generate missing coverage. Use when: AUTOMATICALLY ACTIVATE when user requests coverage analysis:. "check test coverage" or "coverage audit". "what's not tested" or "find untested code"

Structured four-way AI debates between Claude, Sonnet, Gemini, and Codex. Use when: AUTOMATICALLY ACTIVATE when user says:. "/debate <question>". "run a debate about X"

Debug issues methodically — use when stuck on errors, test failures, or unexpected behavior. Use when: AUTOMATICALLY ACTIVATE when encountering bugs or failures:. "fix this bug" or "debug Y" or "troubleshoot X". "why is X failing" or "why isn't X working" or "why doesn't X work"

Present options with trade-offs for informed decision-making. Use when: AUTOMATICALLY ACTIVATE when user requests options or choices:. "fix or provide options" or "fix them or provide me options". "give me options" or "what are my options"

Generate slide decks from briefs with optional multi-AI research. Use when: AUTOMATICALLY ACTIVATE when user requests:. "create a deck", "build slides", "make a presentation". "generate a pitch deck", "create board presentation"

Persist design documents with branch tracking, revision chains, and cross-session discovery. Use when: AUTOMATICALLY ACTIVATE when user says:. "save design" or "save this design". "design document" or "create a design doc"

Convert markdown to DOCX, PPTX, XLSX office documents. Use when: AUTOMATICALLY ACTIVATE when user requests:. Export knowledge work to office formats (e.g., "export to Word", "create PowerPoint", "convert to DOCX"). Generate professional documents from research (e.g., "create presentation from this synthesis")

Post-ship doc sync across project markdown. Use when: "sync docs", "update docs", "document changes", "release notes".

Environment diagnostics — check providers, auth, config, hooks, scheduler, and more. Use when: AUTOMATICALLY ACTIVATE when user asks about:. "doctor" or "run doctor" or "diagnostics". "check my setup" or "is everything working"

Reverse-engineer design systems, tokens, and components from live products or screenshots (beta — token extraction, component analysis, and URL modes are in progress)

Wrap up a branch — run tests, create PR, merge or discard — use when implementation is done. Use when: AUTOMATICALLY ACTIVATE when user requests task completion with git operations:. "commit and push" or "git commit and push". "complete all tasks and commit and push"

Lock in user goals upfront and validate outputs against them — use to prevent scope drift

Track project blockers, bugs, and gaps across sessions — use when issues pile up or need triage. Use when: AUTOMATICALLY ACTIVATE when user mentions:. "issue" or "issues" or "problem". "track this" or "remember this blocker"

Run tasks in a loop until goals are met — use for iterative refinement, polling, or convergence. Use when: AUTOMATICALLY ACTIVATE when user requests iterative execution:. "loop X times" or "loop around N times". "loop around 5 times auditing, enhancing, testing"

Switch to Knowledge Work mode for research and writing — use when task is non-code focused

Craft better prompts using proven optimization techniques — use when your prompt needs refinement. Use when: Use PROACTIVELY when user wants to:. "create a prompt for", "write a prompt for". "optimize this prompt", "improve this prompt"

Multi-tentacled orchestration using Double Diamond methodology. Use when: PRIORITY TRIGGERS (always invoke immediately):. "/octo:multi" (explicit command). "run this with all providers", "run with all providers"

AI-optimized PRD creation with 100-point scoring framework

Pick up where you left off from a previous session — use after context resets, compaction, or new conversations. Use when: AUTOMATICALLY ACTIVATE when user mentions:. "resume" or "continue" or "pick up where I left off". "what was I doing" or "restore session"

Roll back to a previous checkpoint via git — use when a change went wrong and you need to revert. Use when: AUTOMATICALLY ACTIVATE when user mentions:. "rollback" or "revert" or "undo". "go back to" or "restore checkpoint"

Scope drift detection — compares actual diff against stated intent to catch scope creep and missing requirements. Informational only, never blocks.

URL validation and content wrapping for untrusted sources. Use when: This skill provides SECURITY UTILITIES - it should be referenced by other skills,. not invoked directly by users. Auto-integrate when:. Fetching content from URLs

Review code in two passes: spec compliance then quality — use for thorough PR or feature reviews. Use when: Use when completing a major feature, preparing a PR, or when user says. "staged review", "full review", "review against spec", or "two-stage review".

Show where you are in the workflow and what to do next — use for progress checks and orientation. Use when: AUTOMATICALLY ACTIVATE when user asks about:. "status" or "progress" or "where am I". "what's next" or "next step"

Manage tasks with Claude Code native tools — use to track TODOs, delegate work, and monitor progress. Use when: AUTOMATICALLY ACTIVATE when user requests task management:. "add to the todo's" or "add this to todos". "resume tasks" or "continue tasks" or "pick up where we left off"

Build features with tests-before-code rigor — use for new features needing test coverage. Use when: Use when implementing any feature, bugfix, or behavior change.. Auto-invoke when user says "implement X", "add feature Y", "fix bug Z".

Brainstorm creatively with pattern spotting and paradox hunting — use for ideation and exploration. Use when: Use PROACTIVELY when user wants to:. "brainstorm", "think through this with me". "help me explore ideas", "creative session"

Verify claims with actual evidence before declaring success — use to prevent false completion. Use when: Use when about to claim work is complete, fixed, or passing.. Auto-invoke before: commits, PRs, task completion, moving to next task.. ALWAYS use before expressing satisfaction ("Done!", "Fixed!", "All passing!").

Process screenshot-based UI/UX feedback to fix visual issues. Use when: AUTOMATICALLY ACTIVATE when user provides visual feedback:. "[Image X] The /settings should be Y". "[Image X] these button styles need to be fixed"

Zero-context implementation plans with bite-sized tasks. Use when: Use when you have a spec or requirements for a multi-step task.. Auto-invoke when user says "plan how to implement X", "create implementation plan", . "break down this feature into tasks".

Configure Claude Octopus providers and preferences. Use when: Use this skill when the user wants to "configure Claude Octopus", "setup octopus",. "configure providers", "set up API keys for octopus", or mentions octopus configuration.