ai-agent

superpowers

Name: superpowers
Author: obra

An agentic skills framework & software development methodology that works.

297,071 stars+2,395★ this week26,523 forksShellUpdated 10/10/2026100% free · open source

What it does

Superpowers is an AI-agent framework and software development methodology that enables founders to build autonomous systems that can learn, reason, and act on their behalf.

When to use it

•When building autonomous systems that require decision-making and problem-solving capabilities
•When integrating multiple AI models and services into a single workflow
•When developing applications that need to adapt to changing environments and user needs

Ready-to-paste prompt

./superpowers run --goal 'maximize_user_engagement' --env 'production'

Heads up: Make sure to set the `SUPERPOWERS_LICENSE_KEY` environment variable before running the agent, as it requires a valid license key to operate

Saves to your device

Use with Claude

New

Skip the builder — one click puts this in Claude, Cursor, Antigravity and more.

⚡ Runs out of the box

A prompt/skill package — nothing to install beyond adding it to your AI tool.

Try it instantly — no install

Claude Code

mkdir -p ~/.claude/skills/superpowers && curl -fsSL https://workflowstacks.com/api/skills/superpowers/claude-skill -o ~/.claude/skills/superpowers/SKILL.md

Open in another AI app

Opens the app with this repo with the prompt ready to go — no copy-paste needed.

Connect the whole catalog (MCP)

claude mcp add --transport http workflowstacks https://workflowstacks.com/api/mcp

Adds a WorkflowStacks connector to Claude Code: search and load any skill here by chatting.

How superpowers works

Codeflow

Free to inspect

Superpowers is a medium Shell project (~10k lines across 62 code files). You install it into your AI tool with one command; there is nothing to run yourself. Last commit this month, MIT license, has a test suite.

Size

Medium codebase

~10k lines · 62 code files · ~1 h to skim

Setup

Install as a skill / plugin

Add it to Claude Code (or your AI tool) with one command — 14 skills inside. Nothing to run yourself.

Runs on

Inside your AI tool

Helper scripts use Node.js

Shell 54%JavaScript 36%Python 5%TypeScript 2%HTML 2%

Where to start reading

1
README.md
Start here — what it does and how to install it
2
AGENTS.md
The instructions the AI actually follows
3
package.json
Dependencies and the commands it exposes
4
skills/brainstorming/SKILL.md
Inside skills/ — an example of what the AI is told to do

What's in each folder

tests/Tests — proof it works59 files

skills/Prompts, skills & agent definitions51 files

docs/Documentation43 files

.github/CI / automation (GitHub Actions)6 files

hooks/Hooks — scripts that auto-run on events4 files

scripts/Helper scripts4 files

.claude-plugin/Plugin manifest — what gets installed2 files

.hermes-plugin/Plugin manifest — what gets installed2 files

READMEHas testsDocumentedMIT licenseUpdated this month

Use with Claude

New

Skip the builder — one click puts this in Claude, Cursor, Antigravity and more.

⚡ Runs out of the box

A prompt/skill package — nothing to install beyond adding it to your AI tool.

Try it instantly — no install

Claude Code

mkdir -p ~/.claude/skills/superpowers && curl -fsSL https://workflowstacks.com/api/skills/superpowers/claude-skill -o ~/.claude/skills/superpowers/SKILL.md

Open in another AI app

Opens the app with this repo with the prompt ready to go — no copy-paste needed.

Connect the whole catalog (MCP)

claude mcp add --transport http workflowstacks https://workflowstacks.com/api/mcp

Adds a WorkflowStacks connector to Claude Code: search and load any skill here by chatting.

Quick Actions

Details

Creator

obra

Language

Shell