By nocksock
Core skills library for Claude Code: TDD, debugging, collaboration patterns, and proven techniques
Deprecated - use the superpowers:brainstorming skill instead
do general code cleanup
Deprecated - use the superpowers:executing-plans skill instead
run and fix tests
find and implement low hanging fruits
Use this agent when the user wants to create a new agent configuration or needs help designing a custom agent. This agent guides users through a structured discovery process to build high-quality agent specifications. Examples: - User: "I need to create an agent that helps me write better commit messages" Assistant: "I'm going to use the Task tool to launch the agent-prompt-wizard to guide you through creating this agent configuration through a series of clarifying questions." - User: "Can you help me design an agent for reviewing my German-language Zettelkasten notes?" Assistant: "Let me use the agent-prompt-wizard to work with you on designing this specialized agent through structured questions." - User: "I want to make an agent but I'm not sure how to specify what it should do" Assistant: "Perfect - I'll use the agent-prompt-wizard which will ask you targeted questions to help clarify and design your agent."
Use this agent when a major project step has been completed and needs to be reviewed against the original plan and coding standards. Examples: <example>Context: The user is creating a code-review agent that should be called after a logical chunk of code is written. user: "I've finished implementing the user authentication system as outlined in step 3 of our plan" assistant: "Great work! Now let me use the code-reviewer agent to review the implementation against our plan and coding standards" <commentary>Since a major project step has been completed, use the code-reviewer agent to validate the work against the plan and identify any issues.</commentary></example> <example>Context: User has completed a significant feature implementation. user: "The API endpoints for the task management system are now complete - that covers step 2 from our architecture document" assistant: "Excellent! Let me have the code-reviewer agent examine this implementation to ensure it aligns with our plan and follows best practices" <commentary>A numbered step from the planning document has been completed, so the code-reviewer agent should review the work.</commentary></example>
Use this agent when the user needs to create, modify, or review Elixir, Phoenix, or Phoenix LiveView code. This includes: - Writing backend business logic in contexts (e.g., Accounts, Fulfilment, Warehouse) - Creating or modifying Phoenix LiveView modules - Implementing database schemas, migrations, and queries with Ecto - Setting up routes, controllers, and LiveView sessions - Working with PubSub, GenServers, or other Elixir/OTP patterns - Reviewing backend code for idiomatic Elixir patterns and anti-patterns - Implementing authentication, authorization, or session management - Creating background jobs with Oban - Writing backend tests with ExUnit Examples: Example 1: user: "I need to create a new LiveView for managing warehouse terminals with CRUD operations" assistant: "I'll use the phoenix-backend-dev agent to implement the Terminal LiveView with proper Phoenix patterns and core components." <The assistant would then launch this agent to handle the task> Example 2: user: "Can you review this Fulfilment context module I just wrote? I want to make sure it follows Elixir best practices" assistant: "Let me use the phoenix-backend-dev agent to review your code for idiomatic patterns and potential anti-patterns." <The assistant would then launch this agent to review the code> Example 3: user: "I've just implemented a new order allocation function. Here's the code: [code snippet]" assistant: "I'll use the phoenix-backend-dev agent to review this implementation for Elixir best practices and Phoenix patterns." <The assistant would then launch this agent proactively to review the newly written code> Example 4: user: "Create a new schema for tracking inventory movements with proper Ecto associations" assistant: "I'll launch the phoenix-backend-dev agent to create the schema following Phoenix conventions and Ecto best practices." <The assistant would then launch this agent to handle the schema creation>
You are a specialized agent that helps users write effective prompts for AI systems, particularly Claude.
Use this agent when working with React Three Fiber (R3F) and/or Jotai state management. This includes:
You MUST use this before any creative work - creating features, building components, adding functionality, or modifying behavior. Explores user intent, requirements and design before implementation.
Use when asked to clean up code, or after introducing a new larger feature. Identifies bad patterns, fix warnings.
Use this when writing any kind of UI components in any language (heex, react, web components, and so on). Helps with making them composable and flexible.
Use when user explicitly mentions 'deep work' or signals substantial work ('let's build/implement X'). Sets session preferences upfront to enable autonomous execution. If uncertain, ask: 'Deep Work session or interactive style?'
Use when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies
Uses power tools
Uses Bash, Write, or Edit tools
Own this plugin?
Verify ownership to unlock analytics, metadata editing, and a verified badge. GitHub access is read-only (username + org membership).
Sign in to claimOwn this plugin?
Verify ownership to unlock analytics, metadata editing, and a verified badge. GitHub access is read-only (username + org membership).
Sign in to claimBased on adoption, maintenance, documentation, and repository signals. Not a security audit or endorsement.
Superpowers is a complete software development workflow for your coding agents, built on top of a set of composable "skills" and some initial instructions that make sure your agent uses them.
It starts from the moment you fire up your coding agent. As soon as it sees that you're building something, it doesn't just jump into trying to write code. Instead, it steps back and asks you what you're really trying to do.
Once it's teased a spec out of the conversation, it shows it to you in chunks short enough to actually read and digest.
After you've signed off on the design, your agent puts together an implementation plan that's clear enough for an enthusiastic junior engineer with poor taste, no judgement, no project context, and an aversion to testing to follow. It emphasizes true red/green TDD, YAGNI (You Aren't Gonna Need It), and DRY.
Next up, once you say "go", it launches a subagent-driven-development process, having agents work through each engineering task, inspecting and reviewing their work, and continuing forward. It's not uncommon for Claude to be able to work autonomously for a couple hours at a time without deviating from the plan you put together.
There's a bunch more to it, but that's the core of the system. And because the skills trigger automatically, you don't need to do anything special. Your coding agent just has Superpowers.
If Superpowers has helped you do stuff that makes money and you are so inclined, I'd greatly appreciate it if you'd consider sponsoring my opensource work.
Thanks!
Note: Installation differs by platform. Claude Code or Cursor have built-in plugin marketplaces. Codex and OpenCode require manual setup.
Superpowers is available via the official Claude plugin marketplace
Install the plugin from Claude marketplace:
/plugin install superpowers@claude-plugins-official
In Claude Code, register the marketplace first:
/plugin marketplace add obra/superpowers-marketplace
Then install the plugin from this marketplace:
/plugin install superpowers@superpowers-marketplace
In Cursor Agent chat, install from marketplace:
/add-plugin superpowers
or search for "superpowers" in the plugin marketplace.
Tell Codex:
Fetch and follow instructions from https://raw.githubusercontent.com/obra/superpowers/refs/heads/main/.codex/INSTALL.md
Detailed docs: docs/README.codex.md
Tell OpenCode:
Fetch and follow instructions from https://raw.githubusercontent.com/obra/superpowers/refs/heads/main/.opencode/INSTALL.md
Detailed docs: docs/README.opencode.md
gemini extensions install https://github.com/obra/superpowers
To update:
gemini extensions update superpowers
Start a new session in your chosen platform and ask for something that should trigger a skill (for example, "help me plan this feature" or "let's debug this issue"). The agent should automatically invoke the relevant superpowers skill.
brainstorming - Activates before writing code. Refines rough ideas through questions, explores alternatives, presents design in sections for validation. Saves design document.
using-git-worktrees - Activates after design approval. Creates isolated workspace on new branch, runs project setup, verifies clean test baseline.
writing-plans - Activates with approved design. Breaks work into bite-sized tasks (2-5 minutes each). Every task has exact file paths, complete code, verification steps.
subagent-driven-development or executing-plans - Activates with plan. Dispatches fresh subagent per task with two-stage review (spec compliance, then code quality), or executes in batches with human checkpoints.
test-driven-development - Activates during implementation. Enforces RED-GREEN-REFACTOR: write failing test, watch it fail, write minimal code, watch it pass, commit. Deletes code written before tests.
requesting-code-review - Activates between tasks. Reviews against plan, reports issues by severity. Critical issues block progress.
finishing-a-development-branch - Activates when tasks complete. Verifies tests, presents options (merge/PR/keep/discard), cleans up worktree.
The agent checks for relevant skills before any task. Mandatory workflows, not suggestions.
Testing
npx claudepluginhub nocksock/superpowersCore skills library for Claude Code: TDD, debugging, collaboration patterns, and proven techniques
Superpowers Plus core skills library for Claude Code: planning, execution routing, TDD, debugging, and collaboration workflows
Harness-native ECC operator layer - 67 agents, 278 skills, 94 legacy command shims, reusable hooks, rules, selective install profiles, and production-ready workflows for Claude Code, Codex, OpenCode, Cursor, and related agent harnesses
Evidence-gated AI coding workflow: scan → analyze → plan → TDD → execute → fix → verify → review, powered by Codebase Memory MCP >= 0.9.0 with optional Serena LSP intelligence. Includes blast-radius planning, test/cycle gates, independent review, and Windows Git Bash hook auto-resolution.
v9.54.1 — Reliability wave: tangle contextual review correction loop with hard round ceiling, progress-supervised review rounds (per-agent stall watch, descendant-tree kills), council diversity and agy pin fixes, marketplace generator source-of-truth fix, provider troubleshooting runbook and cost-expectations docs. Run /octo:setup.
Claude harness - A harness for solo developers (Vibecoders) to handle full-cycle contract development.