super-agent-skills

super-agent-skills

One command. Full lifecycle. An opinionated Claude Code plugin that turns "I want to build X" into shipped code — with specs, plans, tests, reviews, and documentation along the way.

Just type /superthink and the plugin handles the rest.

/superthink I want to build a task management API

The agent brainstorms the design, writes the spec, plans the implementation, dispatches subagents to build it, runs code reviews, and prompts you when it's ready to ship. Every step follows production-grade engineering standards — TDD, 5-axis code review, STRIDE threat modeling, anti-rationalization tables that catch when the agent tries to cut corners.

Install

# From marketplace
/plugin marketplace add oscarqjh/super-agent-skills
/plugin install super-agent-skills@oscarqjh-super-agent-skills

# Or load locally
git clone https://github.com/oscarqjh/super-agent-skills.git
claude --plugin-dir ./super-agent-skills

SSH errors? The marketplace clones via SSH. Either add your SSH key or run: git config --global url."https://github.com/".insteadOf "[email protected]:"

Replaces both superpowers and agent-skills. Do not install either alongside this plugin. Run /super-agent-skills:audit to check for conflicts.

Setup Guides

Environment	Guide
Claude Code	docs/claude-code-setup.md
Cursor	docs/cursor-setup.md
OpenCode	docs/opencode-setup.md
Gemini CLI	docs/gemini-cli-setup.md
Windsurf	docs/windsurf-setup.md
GitHub Copilot	docs/copilot-setup.md
Any agent	docs/getting-started.md

How It Works

/superthink classifies your intent and routes to the right workflow:

/superthink [what you want to do]
        │
        ├── "build X" ──────── Full lifecycle chain (see below)
        ├── "fix X" ────────── Root-cause debugging (not guessing)
        ├── "review code" ──── 5-axis code review
        ├── "test X" ───────── TDD with spec-driven test generation
        ├── "simplify X" ──── Reduce complexity, preserve behavior
        ├── "ship it" ──────── Pre-merge checklist → merge/PR
        └── "plan X" ───────── Task breakdown with dependency graphs

The Build Chain

When you're building something new, the plugin runs the complete lifecycle:

① Brainstorming          Ask questions, explore approaches, write design spec
        │                 + dispatches code-explorer agent for codebase context
        │                 + generates acceptance test skeletons
        ▼                 + invokes threat-modeling if security-sensitive
② Writing Plans          Break spec into bite-sized tasks with vertical slicing
        │                 + dispatches code-architect agent for design blueprint
        │                 + maps dependency graph, adds checkpoints
        ▼                 + 3-option execution handoff (compound / subagent / inline)
③ Building               Dispatch fresh subagent per task (TDD, incremental)
        │                 + domain skills auto-trigger: API, frontend, security...
        │                 + parallel dispatch for independent tasks (max 3)
        ▼                 + spec compliance review + code quality review per task
④ Code Review            5-axis review with self-healing fix loop (3 rounds)
        │                 + architecture reviewer for design-significant changes
        ▼
⑤ You Choose             "Wrap up" (commit + next task) OR "Ship it" (merge/PR)

Every step has anti-rationalization tables that catch shortcuts, and hooks that enforce handoffs. See Architecture for the complete process graph with all skills, agents, and hooks.

What's Inside

29 skills, 9 agent personas, 6 reference guides, 12 slash commands, 4 hook types.

Skills carry structured capability frontmatter (phase, produces, requires, companions, chainsTo) that auto-generates a routing index at session start — the agent knows valid next steps without hand-maintained routing tables.

See Architecture for the full inventory and how everything connects.

Documentation

• Architecture — process graph, skill inventory, hook system
• Example Workflows — end-to-end usage examples
• Skill Authoring Guide — how to create new skills
• Contributing — how to contribute to this plugin
• Changelog — release history
• MCP Integrations — recommended MCP servers

Credits