Agent skill

Superpowers Sync Upstream

by christopherarter in christopherarter/superpowers-reasonix

Sync this port with upstream obra/superpowers or Reasonix main-v2: detect drift, re-port, bench-gate

MITAuto-check passedDevelopment

Install Superpowers Sync Upstream

skills CLI
$ npx skills add christopherarter/superpowers-reasonix --skill superpowers-sync-upstream -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install christopherarter/superpowers-reasonix superpowers-sync-upstream --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/christopherarter/superpowers-reasonix.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/superpowers-sync-upstream .claude/skills/superpowers-sync-upstream && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
superpowers-sync-upstream
GitHub stars
102
Token cost
~752 tokens
SKILL.md length
352 words
Files
1
Skills in repo
11
Repo updated
First seen
Licence
MIT

At a glance

Sync this port with upstream obra/superpowers or Reasonix main-v2: detect drift, re-port, bench-gate

  • Works in 6 steps: Detect → Classify content drift → Re-port → …
  • Development work in your project
  • SKILL.md covers 1. Detect, 2. Classify content drift, 3. Re-port and 4. Classify harness drift, plus 2 more sections
  • Calls git and node

What it does

Superpowers Sync Upstream is an agent skill from christopherarter/superpowers-reasonix. Sync this port with upstream obra/superpowers or Reasonix main-v2: detect drift, re-port, bench-gate

Its SKILL.md is about 750 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Development. It works with Git. The repository describes itself as: Superpowers skill port to Reasonix coding harness. The licence is MIT.

When your agent uses it

  • Development work in your project

Example prompts

  • “/superpowers-sync-upstream”

Workflow steps

6 steps, taken from the step headings in SKILL.md.

  1. Detect
  2. Classify content drift
  3. Re-port
  4. Classify harness drift
  5. Bench-gate
  6. Finalize

What it can do on your machine

Read from SKILL.md and the folder at commit d202ba4. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • git
    • node

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use git, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Superpowers Sync Upstream loads about 752 tokens when it runs. Until then it costs about 32 tokens; SKILL.md has 352 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~32
When it runs · the whole SKILL.md, loaded when a task matches
~752

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from christopherarter/superpowers-reasonix at commit d202ba4, republished under its MIT licence (© christopherarter). 352 words, ~752 tokens.

Download SKILL.mdSave it as .claude/skills/superpowers-sync-upstream/SKILL.md (or your agent's skills folder).
name
superpowers-sync-upstream
description
Sync this port with upstream obra/superpowers or Reasonix main-v2: detect drift, re-port, bench-gate

Sync Upstream

Re-aligns this port with its two upstreams and re-pins UPSTREAM.json. Run when asked to sync or update from upstream, or after the upstream-drift CI issue fires.

1. Detect

Read UPSTREAM.json for the pinned commits and watched paths, then see what moved:

node .github/scripts/check-upstream-drift.mjs prints which upstreams drifted (read-only).

For full diffs, shallow-fetch and compare from the pins:

git clone --filter=blob:none --no-checkout <obra.repo> /tmp/obra && git -C /tmp/obra diff <obra.lastSyncedCommit>..HEAD -- skills/

git clone --filter=blob:none --no-checkout <reasonix.repo> /tmp/rx && git -C /tmp/rx diff <reasonix.lastVerifiedCommit>..origin/main-v2 -- internal/tool internal/hook internal/skill internal/frontmatter internal/command

Network blocked? web_fetch the GitHub compare page: <repo>/compare/<pinned>...<branch>. This step is read-only; dispatch it to a task subagent and keep only the drift report to save context.

2. Classify content drift

For each changed obra skill, decide edited, new, or removed.

  • New skill: port it only if no native Reasonix tool already covers it (task, review, wait, explore). Otherwise add it to UPSTREAM.json retired with a one-line reason.
  • Removed upstream skill: consider retiring the port equivalent.

3. Re-port

Load superpowers-writing-skills. For each edited or to-be-ported skill, apply the Adaptations rules: snake_case tool names (read_file, edit_file, bash), description rewritten as a forceful imperative within the 130-char index budget, references/* auto-fold, native-tool substitution, path renames (docs/reasonix/...). Preserve the disciplines verbatim: Iron Laws, red-flag tables, RED-GREEN-REFACTOR. Keep bodies lean enough for the flash model.

Show full SKILL.md (134 more words)Show less

4. Classify harness drift

Map each changed contract file to the port surface it touches:

  • internal/tool: tool names in every skill body and bench/reasonix.toml
  • internal/hook: AGENTS.md notes and any hook docs
  • internal/frontmatter: all skill frontmatter
  • internal/skill, internal/command: layout, loading, and /name assumptions

Update the affected skills, AGENTS.md, and bench config. If the change invalidated the local reasonix binary, rebuild it before trusting bench.

5. Bench-gate

  • node --test bench/structural.test.mjs (structure of every SKILL.md)
  • node bench/bench.mjs (invocation; prior cases must still pass)
  • exec-fidelity for any re-ported discipline skill, vs bench/BASELINE.json

Any structural failure or exec score below baseline blocks acceptance. Fix the skill body; do not lower the baseline.

6. Finalize

Bump UPSTREAM.json commits and dates to the synced HEADs, close the open upstream-drift issue, write a short report (changed, ported, retired, bench result), and commit.

© christopherarter, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/superpowers-sync-upstream of christopherarter/superpowers-reasonix.

Open the folder on GitHubat commit d202ba4

Compare with similar skills

Superpowers Sync Upstream next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Superpowers Sync Upstream compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Superpowers Sync Upstream this skillchristopherarter/superpowers-reasonix102—~752Automated safety check: PassMIT
Finishing a Development Branchobra/superpowers296k5 repos~1.9kAutomated safety check: PassMIT
Code Review ChecklistshareAI-lab/learn-claude-code78k5 repos~1.1kAutomated safety check: PassMIT
Codebase Knowledge Graph Q&AEgonex-AI/Understand-Anything86k1 repos~1.2kAutomated safety check: PassMIT
Code Design Rationale Investigatorcursor/plugins10k9 repos~2.6kAutomated safety check: PassNone
Understand Diff AnalysisEgonex-AI/Understand-Anything86k1 repos~1.4kAutomated safety check: PassMIT

Similar skills

  • Walks the last step of a branch: confirm tests pass, detect the git environment, ask how to integrate, carry out your choice and clean up the worktree.

    296k GitHub starsUsed in 5 repos~1.9k tokens
    DevelopmentAuto-check passed
  • Code Review Checklist

    shareAI-lab/learn-claude-code

    Reviews code against a five-part checklist covering security, correctness, performance, maintainability and testing, and reports findings in a fixed format.

    78k GitHub starsUsed in 5 repos~1.1k tokens
    DevelopmentAuto-check passed
  • Codebase Knowledge Graph Q&A

    Egonex-AI/Understand-Anything

    Answers questions about a codebase by searching a prebuilt knowledge graph of its files, functions, classes and dependencies, not by rereading every source file.

    86k GitHub starsUsed in 1 repo~1.2k tokens
    DevelopmentAuto-check passed
  • Official

    Digs into why code is shaped the way it is by checking git history, pull requests and connected tools in parallel, then reporting a cited read on the tradeoffs.

    10k GitHub starsUsed in 9 repos~2.6k tokens
    DevelopmentAuto-check passed
  • Understand Diff Analysis

    Egonex-AI/Understand-Anything

    Reads your git changes or a pull request against a prebuilt knowledge graph of the project to explain what changed, which components are affected and what is risky.

    86k GitHub starsUsed in 1 repo~1.4k tokens
    DevelopmentAuto-check passed
  • Understand Explain

    Egonex-AI/Understand-Anything

    Gives an in-depth explanation of one file, function or module by reading the project's knowledge graph and checking that the graph is still fresh.

    86k GitHub starsUsed in 1 repo~1.3k tokens
    DevelopmentAuto-check passed

More from christopherarter/superpowers-reasonix

All 11 skills in this repo
  • Superpowers Systematic Debugging

    christopherarter/superpowers-reasonix

    Any bug, failing or flaky test, or surprise behavior?. An agent skill from christopherarter/superpowers-reasonix.

    102 GitHub stars~2k tokensUpdated 1 mo ago
    Auto-check passed
  • Superpowers Test Driven Development

    christopherarter/superpowers-reasonix

    Writing or fixing any code?. An agent skill from christopherarter/superpowers-reasonix.

    102 GitHub stars~1.9k tokensUpdated 1 mo ago
    Auto-check passed
  • Superpowers Writing Skills

    christopherarter/superpowers-reasonix

    Creating, editing, or testing a Reasonix skill?. An agent skill from christopherarter/superpowers-reasonix.

    102 GitHub stars~2.8k tokensUpdated 1 mo ago
    Auto-check passed
  • Superpowers Brainstorming

    christopherarter/superpowers-reasonix

    Building a feature or starting from an idea?. An agent skill from christopherarter/superpowers-reasonix.

    102 GitHub stars~1.7k tokensUpdated 1 mo ago
    Auto-check passed
  • Superpowers Finishing A Development Branch

    christopherarter/superpowers-reasonix

    Branch finished, tests green?. An agent skill from christopherarter/superpowers-reasonix.

    102 GitHub stars~1.3k tokensUpdated 1 mo ago
    Auto-check passed
  • Superpowers Receiving Code Review

    christopherarter/superpowers-reasonix

    Got review feedback?. An agent skill from christopherarter/superpowers-reasonix.

    102 GitHub stars~1.2k tokensUpdated 1 mo ago
    Auto-check passed

Works with

Categories

Questions about Superpowers Sync Upstream

What does Superpowers Sync Upstream do?

Sync this port with upstream obra/superpowers or Reasonix main-v2: detect drift, re-port, bench-gate. Superpowers Sync Upstream is an agent skill from christopherarter/superpowers-reasonix.

When should I use Superpowers Sync Upstream?

Superpowers Sync Upstream fits situations like: development work in your project.

How do I install Superpowers Sync Upstream in Claude Code?

Run `npx skills add christopherarter/superpowers-reasonix --skill superpowers-sync-upstream -a claude-code`. Or copy the skill folder (skills/superpowers-sync-upstream in christopherarter/superpowers-reasonix) into .claude/skills/superpowers-sync-upstream in your project. Claude Code loads it when a task matches its description.

How do I install Superpowers Sync Upstream in Codex?

Run `npx skills add christopherarter/superpowers-reasonix --skill superpowers-sync-upstream -a codex`. Or copy the skill folder (skills/superpowers-sync-upstream in christopherarter/superpowers-reasonix) into .agents/skills/superpowers-sync-upstream in your project. Codex loads it when a task matches its description.

Can I use Superpowers Sync Upstream in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add christopherarter/superpowers-reasonix --skill superpowers-sync-upstream -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/superpowers-sync-upstream, .gemini/skills/superpowers-sync-upstream, .github/skills/superpowers-sync-upstream and .opencode/skills/superpowers-sync-upstream in your project.

What does Superpowers Sync Upstream need to run?

Going by SKILL.md and its folder, Superpowers Sync Upstream needs the command-line tools its instructions call (git and node).

Does Superpowers Sync Upstream access the network?

SKILL.md contains no URLs. Its commands use git, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Superpowers Sync Upstream safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Superpowers Sync Upstream use?

Superpowers Sync Upstream is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Superpowers Sync Upstream use?

About 752 tokens (SKILL.md is roughly 3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Superpowers Sync Upstream?

Skills that share tags, products or a category with Superpowers Sync Upstream: Finishing a Development Branch (obra/superpowers, 296k stars), Code Review Checklist (shareAI-lab/learn-claude-code, 78k stars), Codebase Knowledge Graph Q&A (Egonex-AI/Understand-Anything, 86k stars) and Code Design Rationale Investigator (cursor/plugins, 10k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Superpowers Sync Upstream?

christopherarter (a GitHub user) maintains it in christopherarter/superpowers-reasonix, which has 102 GitHub stars. The repository holds 11 skills in this directory. The repository was last updated on August 20, 2026.

Source: christopherarter/superpowers-reasonix on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.