# superpowers | Jesse Vincent | Knowledge Base | Instagit

An agentic skills framework & software development methodology that works.

GitHub Stars: 52.1k

Repository: https://github.com/obra/superpowers

---

## Articles

### [Maximum Nesting Depth for Skill Discovery in Superpowers](/obra/superpowers/what-is-the-maximum-nesting-depth-for-skill-discovery)

Discover the maximum nesting depth for skills in Superpowers. Learn how to configure it via the maxDepth parameter to optimize your skill discovery process.

- Tags: deep-dive
- Published: 2026-02-19

### [How to Check for Superpowers Plugin Updates: 3 Methods Explained](/obra/superpowers/how-can-i-check-for-superpowers-plugin-updates)

Learn 3 easy methods to check for Superpowers plugin updates using console commands, git pull, or programmatic calls. Keep your Superpowers plugin current.

- Tags: how-to-guide
- Published: 2026-02-16

### [Superpowers Plugin Configuration: Core Components and Architecture](/obra/superpowers/what-are-main-components-of-superpowers-plugin-configuration)

Explore the eight core components of Superpowers plugin configuration including front-matter extractor path normalizer and factory function to enhance your OpenCodeai chat sessions.

- Tags: architecture
- Published: 2026-02-16

### [How Subagents Power the Superpowers Development Workflow: A Complete Guide](/obra/superpowers/what-is-the-role-of-subagents-in-superpowers-development-workflow)

Discover how subagents in the Superpowers workflow automate TDD and code review. Learn about Implementer, Spec-Compliance, and Code-Quality Reviewer roles for efficient development.

- Tags: how-to-guide
- Published: 2026-02-16

### [How Design Documents Are Named and Structured in Superpowers](/obra/superpowers/how-are-design-documents-named-and-structured)

Learn how Superpowers names and structures design documents using Markdown files under docs plans with a YYYY-MM-DD topic design format and standardized sections for clarity.

- Tags: best-practices
- Published: 2026-02-16

### [YAML Frontmatter Format for Superpowers Skills: Complete Specification](/obra/superpowers/what-is-yaml-frontmatter-format-for-superpowers-skills)

Learn the exact YAML frontmatter format for Superpowers skills. Discover the required name and description fields and their specifications for SKILL.md files.

- Tags: api-reference
- Published: 2026-02-16

### [Where to Find Core Skill Management Utilities in the Superpowers Repository](/obra/superpowers/where-can-i-find-core-skill-management-utilities)

Find core skill management utilities in the Superpowers repository within lib/skills-core.js. Discover helpers for skill discovery, parsing, and resolution.

- Tags: internals
- Published: 2026-02-16

### [How Superpowers Facilitates Automated Code Reviews: A Two-Stage Subagent Workflow](/obra/superpowers/how-does-superpowers-facilitate-code-reviews)

Superpowers automates code reviews using a two-stage subagent workflow. Ensure spec compliance and code quality before task completion. Streamline your development process.

- Tags: how-to-guide
- Published: 2026-02-16

### [How Superpowers Handles Manual Invocation of Skills: A Complete Technical Guide](/obra/superpowers/how-does-superpowers-handle-manual-invocation-of-skills)

Discover how Superpowers enforces manual invocation of skills with its three-layer system: tool gating, slash-command flags, and OpenCode @mention syntax for user-triggered execution.

- Tags: how-to-guide
- Published: 2026-02-16

### [How to Finish a Development Branch in Superpowers: Complete Workflow Guide](/obra/superpowers/what-is-the-process-for-finishing-a-development-branch-in-superpowers)

Safely finish your development branch in Superpowers. Learn the complete workflow, from test verification to automatic cleanup, ensuring a seamless integration.

- Tags: how-to-guide
- Published: 2026-02-16

### [How Skills Are Discovered Recursively in Superpowers: A Deep Dive into the Filesystem Scanner](/obra/superpowers/how-are-skills-discovered-recursively-in-superpowers)

Discover how Superpowers recursively finds skills by scanning the filesystem up to three levels deep, parsing SKILL.md files to build a capability catalog.

- Tags: deep-dive
- Published: 2026-02-16

### [How Superpowers Supports AI Coding Agents: Claude Code and Codex Integration](/obra/superpowers/how-does-superpowers-support-ai-coding-agents)

Learn how Superpowers integrates AI coding agents like Claude Code and Codex, enabling seamless discovery, loading, and execution of workflow capabilities without agent code changes.

- Tags: deep-dive
- Published: 2026-02-16

### [What Is the `superpowers:` Prefix in Skill Names? A Deep Dive into the obra/superpowers Namespace](/obra/superpowers/what-is-the-purpose-of-superpowers-prefix-in-skill-names)

Discover the purpose of the superpowers: prefix in skill names. Learn how this namespace prevents collisions and ensures unambiguous execution of built-in capabilities from the obra/superpowers repository.

- Tags: deep-dive
- Published: 2026-02-16

### [How the Brainstorming Skill Works in Superpowers: A Complete Technical Guide](/obra/superpowers/how-does-the-brainstorming-skill-work-in-superpowers)

Discover how the brainstorming skill in Superpowers enforces design before implementation. Learn the six-step checklist and hard-gated state machine for approved feature designs.

- Tags: deep-dive
- Published: 2026-02-16

### [When Is the Test-Driven-Development Skill Mandatory in Superpowers?](/obra/superpowers/when-is-test-driven-development-skill-mandatory)

Master test-driven development in obra/superpowers when adding or changing code. Ensure failing tests precede implementation and verify red/green states for robust development.

- Tags: best-practices
- Published: 2026-02-16

### [Test-Driven Development Skill Rules: A Complete Guide to the TDD Workflow](/obra/superpowers/what-are-the-rules-for-writing-code-within-test-driven-development-skill)

Master test-driven development with our guide to the TDD workflow. Learn to write failing tests first, implement minimal code, and refactor for clean, green results.

- Tags: how-to-guide
- Published: 2026-02-16

### [Understanding the Constraints of the Brainstorming Skill in Superpowers](/obra/superpowers/what-are-the-constraints-of-the-brainstorming-skill)

Explore the six strict constraints of the brainstorming skill in Superpowers. Learn how the pre-condition, gate, checklist, and terminal state prevent implementation until design approval.

- Tags: deep-dive
- Published: 2026-02-16

### [How the Superpowers Test-Driven-Development Skill Enforces the RED-GREEN-REFACTOR Cycle](/obra/superpowers/how-does-superpowers-test-driven-development-skill-enforce-red-green-refactor-cycle)

Discover how the Superpowers test-driven-development skill enforces the RED-GREEN-REFACTOR cycle with mandatory verification gates and automated checklists. Learn to write better code faster.

- Tags: how-to-guide
- Published: 2026-02-16

### [How to Override Default Superpowers Skills with Your Own Custom Skills](/obra/superpowers/can-i-override-default-superpowers-skills-with-my-own)

Easily override default Superpowers skills by creating custom skills in your OpenCode config. Learn how to extend functionality and personalize your workflow.

- Tags: how-to-guide
- Published: 2026-02-16

### [Superpowers Core Development Workflow: The 7-Stage Mandatory Pipeline for AI Software Engineering](/obra/superpowers/what-is-the-core-development-workflow-enforced-by-superpowers)

Discover the Superpowers core development workflow a 7-stage pipeline ensuring AI code quality through mandatory design approval, testing, and multi-stage reviews before production.

- Tags: workflow
- Published: 2026-02-16

### [How to Define Metadata for a Skill in Superpowers: A Complete Guide](/obra/superpowers/how-do-i-define-metadata-for-a-skill-in-superpowers)

Learn to define metadata for a skill in Superpowers by adding a YAML front-matter block with name and description fields to your SKILL.md file. Get started now.

- Tags: how-to-guide
- Published: 2026-02-16

### [How the Skill Shadowing Mechanism Works in Superpowers](/obra/superpowers/how-does-skill-shadowing-work-in-superpowers)

Discover how Superpowers skill shadowing works. Learn how personal skills override core skills and how the superpowers prefix enforces core directory lookups for a seamless development experience.

- Tags: internals
- Published: 2026-02-16

### [File Structure for a Superpowers Skill: Complete Guide to the skills/ Directory Layout](/obra/superpowers/what-is-the-file-structure-for-a-superpowers-skill)

Learn the Superpowers skill file structure. Discover the required SKILL.md format for metadata, checklists, and workflows within the skills/ directory.

- Tags: how-to-guide
- Published: 2026-02-16

### [Superpowers Skills File Structure: A Complete Guide to the obra/superpowers Repository](/obra/superpowers/superpowers-skill-file-structure)

Explore the Superpowers skills file structure. Learn how each skill in the obra/superpowers repository uses the SKILL.md file for metadata. Unlock efficient development.

- Tags: how-to-guide
- Published: 2026-02-15

### [How Superpowers Checks for Updates: Inside the `checkForUpdates` Git Integration](/obra/superpowers/how-superpowers-checks-for-updates)

Learn how Superpowers checks for updates using a git fetch and status command. Discover the `checkForUpdates` function in the obra/superpowers repository.

- Tags: internals
- Published: 2026-02-15

### [How to Strip YAML Frontmatter from Superpowers Skill Content](/obra/superpowers/how-to-strip-yaml-frontmatter-superpowers-skills)

Effortlessly strip YAML frontmatter from Superpowers skill content using the stripFrontmatter function. Get clean executable Markdown by removing metadata blocks easily.

- Tags: how-to-guide
- Published: 2026-02-15

### [How Superpowers Handles Skill Shadowing Between Personal and Superpower Skills](/obra/superpowers/how-superpowers-handles-skill-shadowing)

Discover how Superpowers handles skill shadowing between personal and superpower skills using a deterministic algorithm that prioritizes personal skills unless superpowers prefix is specified.

- Tags: internals
- Published: 2026-02-15

### [How to Find Skills in the Superpowers Project Directory](/obra/superpowers/how-to-find-skills-in-superpowers-directory)

Discover how to find skills in the Superpowers project directory. Explore the skills directory search markdown files or inspect the dynamic loader to locate them.

- Tags: how-to-guide
- Published: 2026-02-15