Superpowers for Claude Code
https://github.com/obra/superpowers-developing-for-claude-code- Category
- AI Agents
- Rank
- No. 1153Tools index
- Pricing
- Open Source
- Type
- TOOL
- Builder
- obra
- GitHub
- 140 stars
- Date
About
Skill pack for developing Claude Code skills — meta-tooling for the agent ecosystem by Jesse Vincent (obra).
What it does
It combines an agent-readable Claude Code reference library with a practical plugin-building workflow. Claude selects the relevant skill from the task description, then consults focused documentation, patterns, troubleshooting advice, or teaching examples. A Node.js updater can refresh the bundled official documentation from Anthropic’s documentation index.
Why it's ranked here
This is a strong learning and reference package because it joins broad official documentation with an end-to-end development workflow. The guidance covers planning, components, local testing, release, distribution, and maintenance. Its examples make abstract plugin concepts concrete, although the MCP example stops at structure rather than implementing a working protocol server.
What's good
Progressive disclosure keeps agents from loading the entire reference collection for every question. The development workflow explains component choices, portable configuration, local installation, debugging, semantic versioning, and distribution. Two examples show both a minimal skill-only plugin and a fuller composition of skills, commands, hooks, and MCP configuration. Cross-platform hook guidance covers Windows, macOS, and Linux.
Tradeoffs
Installation uses a development marketplace and requires restarting Claude Code. The documentation is a stored snapshot until its updater runs, and updating requires network access plus Node.js. The included MCP server is explicitly a placeholder without tools or protocol handling. Dedicated testing guidance and a production MCP server guide are described as future additions, not current capabilities.
How to use it well
Use it when creating, extending, debugging, releasing, or maintaining Claude Code plugins. Start with the workflow skill, consult the narrower official reference when syntax or configuration details matter, and copy patterns from the examples before testing through a local marketplace. It does not supply a production MCP implementation or replace project-specific tests and validation.
Technical notes+
The plugin manifests are .claude-plugin/plugin.json and .claude-plugin/marketplace.json. skills/working-with-claude-code/SKILL.md routes questions into bundled Markdown references, while skills/developing-claude-code-plugins/SKILL.md defines the lifecycle workflow. skills/working-with-claude-code/scripts/update_docs.js uses Node.js core https, fs, and path, extracts Claude Code Markdown URLs from https://docs.claude.com/llms.txt, downloads them sequentially, writes them into the references directory, and exports getClaudeCodeUrls plus fetchAndSaveDoc. examples/full-featured-plugin/hooks/hooks.json registers SessionStart and PostToolUse hooks through examples/full-featured-plugin/hooks/run-hook.cmd, a Windows and Unix polyglot wrapper. examples/full-featured-plugin/mcp/server.js only logs startup messages and keeps stdin open; it does not use the MCP SDK or expose tools.
Observed
- License
- MIT
- Package surface
- Claude Code plugin containing two skills, bundled Markdown references, updater script, and teaching examples
- Installation surface
- Added as a Claude Code development marketplace, installed with plugin commands, then loaded after restart
- Implementation
- Markdown-based skills and documentation with Node.js JavaScript, shell scripts, JSON manifests, and a CMD polyglot wrapper
- Interfaces
- Claude Code skills and plugin commands, hooks, and an illustrative MCP server surface
- Platform support
- The documented hook wrapper targets Windows, macOS, and Linux
- Reference structure
- The README describes 42 bundled Claude Code documentation files with progressive disclosure and a self-update script
Read from README.md, skills/working-with-claude-code/scripts/update_docs.js, examples/full-featured-plugin/mcp/server.js, CHANGELOG.md, .claude-plugin/plugin.json, .claude-plugin/marketplace.json, examples/full-featured-plugin/README.md, examples/simple-greeter-plugin/README.md, skills/working-with-claude-code/SKILL.md, skills/developing-claude-code-plugins/SKILL.md, examples/full-featured-plugin/hooks/hooks.json, examples/full-featured-plugin/commands/hello.md, examples/full-featured-plugin/hooks/run-hook.cmd, examples/full-featured-plugin/hooks/post-write.sh, skills/working-with-claude-code/references/iam.md.
What it can do
Develop Claude Code skills
Skill requirements or specifications → Custom Claude Code skills
Create meta-tools for AI agents
Agent ecosystem requirements → Meta-tooling solutions
Build agent development workflows
Development process specifications → Structured agent workflows
Generate code skill templates
Skill type and parameters → Code skill templates
Enhance Claude Code functionality
Existing Claude Code setup → Extended capabilities and features
Tags
Tech Stack
Comments (0)
No comments yet
Editorially curated, with community endorsements as a secondary signal. Corrections welcome.