Skip to content
/
Tier A A4 Markdown scaffold Variant Stub

Superpowers: Developing for Claude Code

superpowers-developing-for-claude-code · obra/superpowers-developing-for-claude-code · ★ 129 · last commit 2025-12-03

Gives Claude Code comprehensive, self-updating knowledge of the Claude Code platform for building plugins, skills, hooks, commands, and MCP servers.

Best whenDocumentation should be bundled with the skill and updatable on demand — a skill that can update its own knowledge stays useful as the platform evolves.
Skip ifReading large helper scripts into context (use them as black boxes)
vs seeds
superpowersseed (canonical=false). Adds 2 meta-skills for Claude Code platform development — not development methodology but platfo…
Primitive shape 2 total
Skills 2
00

Summary

Superpowers: Developing for Claude Code — Summary

Superpowers: Developing for Claude Code is a 2-skill plugin that gives Claude Code comprehensive, always-current knowledge of the Claude Code platform itself — bundling 42 official documentation files (working-with-claude-code) and streamlined plugin development workflows (developing-claude-code-plugins) for building skills, commands, hooks, and MCP servers.

The working-with-claude-code skill includes a self-update script that fetches the latest docs from docs.claude.com on demand, meaning the skill never goes stale — it can regenerate its own documentation content.

Differs from superpowers (seed): The seed provides development methodology skills (TDD, brainstorming, worktrees). This plugin provides meta-knowledge: how to extend Claude Code itself. It is a developer tooling plugin, not a workflow enforcement plugin. Zero overlap with seed skills.

01

Since Superpowers

Superpowers: Developing for Claude Code — Since Superpowers (Seed Delta)

What This Adds Beyond the Seed

The seed has a writing-skills skill (1 skill for writing superpowers-compatible skills). This plugin replaces and greatly expands that with:

  1. working-with-claude-code — Complete authoritative documentation for Claude Code platform
  2. developing-claude-code-plugins — Streamlined plugin creation workflows

Key Differences from Seed's writing-skills

The seed's writing-skills teaches agents to write skills compatible with the superpowers ecosystem. This plugin teaches agents:

  • The full Claude Code plugin architecture (not just skills)
  • How to build MCP servers and integrate them as plugins
  • How to write hooks (PreToolUse, PostToolUse, SessionStart, etc.)
  • How to create commands (slash commands)
  • How to set up a development marketplace for testing
  • How to release and version plugins

The Self-Update Pattern

The most novel addition: working-with-claude-code contains 42 bundled documentation files plus:

node ~/.claude/plugins/.../skills/working-with-claude-code/scripts/update_docs.js

Or via Claude: "Update the Claude Code documentation in the working-with-claude-code skill"

This fetches live docs from docs.claude.com and regenerates the bundled files. No other seed or lab skill has a self-update mechanism.

Version

v0.3.1 (as of 2025-12-03). First version tracked by the changelog was initial release.

02

New Primitives

Superpowers: Developing for Claude Code — New Primitives

New Skills (2)

working-with-claude-code

  • 42 documentation files bundled from docs.claude.com
  • Topics: plugin development, skill creation, MCP server integration, hooks configuration, CLI commands, VS Code/JetBrains/GitHub Actions integrations, configuration, security, networking, troubleshooting
  • Progressive disclosure pattern: load only what you need
  • Quick reference table for common tasks
  • Self-update script: scripts/update_docs.js fetches latest docs on demand

developing-claude-code-plugins

  • Step-by-step plugin creation workflows
  • Component guides for skills, commands, hooks, and MCP servers
  • Common patterns with working examples
  • Debugging tips and troubleshooting
  • References the plugin itself as a working example ("dogfooding")
  • Synthesizes official docs into actionable steps

New Reference Files (within working-with-claude-code skill)

42 bundled documentation files covering every Claude Code platform feature. These are effectively a local mirror of docs.claude.com for offline/fast access.

New Script (1)

Script Purpose
skills/working-with-claude-code/scripts/update_docs.js Fetches latest Claude Code docs from docs.claude.com and regenerates bundled files

New Examples (within developing-claude-code-plugins skill)

  • examples/simple-greeter-plugin/ — Minimal plugin structure
  • examples/full-featured-plugin/ — All components

Notable Pattern: Dogfooding Reference

The developing-claude-code-plugins skill references this plugin itself as a working example:

"Best practices for portability and testing — References this plugin as a working example"

This means the plugin uses its own structure to demonstrate the patterns it teaches — a self-referential design.

Related frameworks

same archetype · same primary tool · same memory type

BMAD-METHOD ★ 48k
A4 Markdown scaffold

Provides a full agile delivery lifecycle with named expert-persona AI collaborators that elicit the human's best thinking rather…

Agent OS ★ 4.6k
A4 Markdown scaffold

Extracts implicit codebase conventions into token-efficient markdown standards files and injects them selectively into AI agent…

Claude Conductor ★ 367
A4 Markdown scaffold

Gives Claude Code a persistent, cross-linked, auto-analyzed documentation system so it retains codebase context across sessions.

Spec-Driver (Greenfield Spec-Driven Development) ★ 25
A4 Markdown scaffold

Prevents spec rot in AI-assisted development by making implementation changes flow back into evergreen, authoritative specs via…

Anthropic Knowledge Work Plugins ★ 16k
A4 Markdown scaffold

Role-specialized plugin bundles with live MCP connectors that turn Claude into a domain expert for enterprise knowledge workers.

Codex Integration for Claude Code (skill-codex) ★ 1.3k
A4 Markdown scaffold

Single Claude Code skill that handles Codex CLI invocation correctly (stdin blocking, thinking token suppression, session resume)…