What this is
superjawn is a research-augmented variant of obra/superpowers (MIT, Jesse Vincent, v5.0.7). The upstream plugin ships 14 skills covering the full development workflow, brainstorming through finishing a branch. superjawn forks those skills and adds structured research at entry-point stages.
The idea: when you start new work without an upstream artifact (a spec, a plan, a test), a brief research phase catches pitfalls, surfaces prior art, and checks your memory before you commit to an approach. When you're consuming an artifact that was already research-baked, re-researching wastes time and risks conflicting conclusions.
So research fires in three places only: brainstorming, systematic-debugging, and writing-skills. Stale-artifact skills get a lighter freshness check. Everything else is a straight port.
Forked from obra/superpowers
MIT-licensed. Synced against upstream v5.0.7. Modifications carry the same license. Copyright 2025 Jesse Vincent; modifications copyright 2026 Joe Amditis.
Three categories, 13 skills total
Research phase (3 skills), freshness check (1 skill), consumer/straight port (9 skills). Includes all 13 with no soft dependencies on the upstream superpowers plugin, code-reviewer agent dispatches target pr-review-toolkit:code-reviewer.
Standalone by default
Superjawn includes all 13 skills and does not require the upstream superpowers plugin. Install superpowers only if you intentionally want the original skill versions.
How research works
Three categories, one principle: research belongs where work starts from scratch, not where it inherits a baked-in conclusion.
3 entry-point skills
brainstorming, systematic-debugging, writing-skills
Research phase fires by default. Skip only with explicit, written justification per the locked skip protocol.
git log --grep for prior failures in this area
1 stale-artifact skill
executing-plans
Default-skip, the inverse of research. Fires only when a trigger indicates real drift risk.
9 downstream skills
writing-plans, verification-before-completion, + 7 more
No research phase. These skills consume an artifact from an already-researched upstream stage. The handoff carries the conclusions.
superjawn:
Current skill set
superpowers.
| Skill | Category | Status |
|---|---|---|
brainstorming |
Research | Ported (Batch 1) |
writing-plans |
Consumer | Ported (Batch 1) |
executing-plans |
Freshness check | Ported (Batch 1) |
systematic-debugging |
Research | Ported (Batch 2) |
verification-before-completion |
Consumer | Ported (Batch 2) |
receiving-code-review |
Consumer | Ported (Batch 3) |
requesting-code-review |
Consumer | Ported (Batch 3) |
subagent-driven-development |
Consumer | Ported (Batch 4) |
dispatching-parallel-agents |
Consumer | Ported (Batch 4) |
using-git-worktrees |
Consumer | Ported (Batch 4) |
finishing-a-development-branch |
Consumer | Ported (Batch 5) |
using-superjawnrenamed from upstream using-superpowers |
Consumer | Ported (Batch 5) |
writing-skills |
Research | Ported (Batch 5) |
Review and branch updates
requesting-code-reviewnow requires the independent reviewer to come from a different model provider than the author, with effort scaled to risk. The review covers an exact snapshot, fixes get a focused verify-fixes pass, and a reviewer is never swapped because it found problems.receiving-code-reviewcovers multi-finding PRs: read every feedback surface, fix only supported findings in one push, and resolve a thread only after the pushed head contains the fix.finishing-a-development-branchkeeps each PR to one concern, usesRefs #nwhen a deploy step follows merge, and treats merge as a separate decision that needs the owner's approval.- New reference files: cross-provider review, PR feedback repair, claims and cleanup, a testing strategy for
systematic-debugging, and problem framing forbrainstorming.
How to install
Use the Agent Skills route supported by your client. The commands below are the Claude Code plugin route; Codex users can install the skill directories through the open Agent Skills format.
Add the plugin source
Run this once to register the marketplace.
claude plugin marketplace add https://github.com/jamditis/claude-skills-journalism
Install superjawn
Install from the marketplace.
claude plugin install superjawn
After installing, restart Claude Code so the new skills load. Existing sessions can't pick up new plugin versions mid-flight, superjawn:* invocations from a session that started before the install will fall through to upstream.
Existing superpowers users
Superjawn has no soft dependencies on the upstream superpowers plugin, code-reviewer agent dispatches target pr-review-toolkit:code-reviewer (Anthropic-maintained, in @claude-code-plugins). You can run superjawn standalone.
If you want to revert to the upstream plugin: /plugin install superpowers@claude-plugins-official.
Update an existing install
claude plugin update superjawn
After installing or updating, restart Claude Code so the new skills load. Existing sessions can't pick up new plugin versions mid-flight, superjawn:* invocations from a session that started before the update will fall through to upstream.
Skip protocol
The research phase is default-on. Skipping is allowed, but requires a written justification. Below is the locked skip-protocol text shared by all three research-category skills (brainstorming, systematic-debugging, writing-skills), byte-identical across the set so behavior stays predictable across entry points.
superjawn/skills/brainstorming/SKILL.md (and byte-equivalent in systematic-debugging/SKILL.md).
If skipping, write one line into the spec doc: `Skipped research because <reason>. <Verifiable pointer if applicable>.`
**Valid reasons:**
- Trivial scope (typo, comment edit, single-line config)
- Fresh prior research, same topic in current session OR within last 7 days with verifiable spec/plan pointer. **If the pointer doesn't resolve, the skip is invalid.** (Beyond 7 days, repeat the research even if you remember the prior findings, the landscape drifts.)
- User explicit, **must quote the phrase** that authorized the skip.
- Repeat of identical task, **must include a pointer** to the prior successful run.
**Invalid reasons:** "I think I know", "seems straightforward", "moving fast", "user wants this done quickly", "already familiar with this codebase". If those are tempting, do the research.
Credits
obra/superpowers
Original 14-skill plugin by Jesse Vincent. MIT-licensed, v5.0.7 baseline. superjawn forks this work with modifications for research phase insertion.
Modifications
Research phase design, freshness check logic, architecture revision, and all per-skill modifications by Joe Amditis. Carries same MIT license.
MIT License, see superjawn/LICENSE for the full text.