using-superpowers SKILL.md skillA

using-superpowers from sodiumjoe/dotfiles is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add sodiumjoe/dotfiles/using-superpowers@v1.0.1

Pins v1.0.1 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
sodiumjoe/dotfiles
Path
home/.agents/skills/using-superpowers/SKILL.md
Versions recorded
1
Latest version
v1.0.1, committed Sep 24, 2026
Size
4,135 bytes
Repository stars
49
License
none declared

Use when starting any conversation - establishes how to find and use skills, requiring skill invocation before ANY response including clarifying questions.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

<SUBAGENT-STOP>
If you were dispatched as a subagent to execute a specific task, ignore this skill.
</SUBAGENT-STOP>

<EXTREMELY-IMPORTANT>
If you think there is even a 1% chance a skill might apply to what you are doing, you ABSOLUTELY MUST invoke the skill.

IF A SKILL APPLIES TO YOUR TASK, YOU DO NOT HAVE A CHOICE. YOU MUST USE IT.

This is not negotiable. You cannot rationalize your way out of this.
</EXTREMELY-IMPORTANT>

## The Rule

**Invoke relevant or requested skills BEFORE any response or action** — including clarifying questions, exploring the codebase, or checking files. If it turns out wrong for the situation, you don't have to use it.

**Before entering plan mode:** if you haven't already brainstormed, invoke the brainstorming skill first.

Then announce "Using [skill] to [purpose]" and follow the skill exactly. If it has a checklist, create a todo per item.

## Skill Priority

When multiple skills apply, process skills come first — they set the approach, then implementation skills (frontend-design, etc.) carry it out. Brainstorming and systematic-debugging are Superpowers' most common process skills, but the rule holds for any of them.
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add sodiumjoe/dotfiles/using-superpowers@sha256:99c63571c46bc910

The line at the top of this page pins the label v1.0.1, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_pc4khrhy7txbjctf.svg)](https://markdownregistry.com/a/art_pc4khrhy7txbjctf)

2 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 1 version of this file, committed on Sep 24, 2026.

versioncommittedcommitsizeaudit
v1.0.1 latest2026-09-24 1820eae 4,135 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (4135 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

sodiumjoe/dotfiles · 49 stars · license none declared · pushed 2026-11-05 · branch master

API

GET https://markdownregistry.com/api/v1/artifacts/art_pc4khrhy7txbjctf
GET https://markdownregistry.com/api/v1/resolve?ref=sodiumjoe/dotfiles/using-superpowers
GET https://markdownregistry.com/api/v1/blob/99c63571c46bc91009a7a1988adc83d3b84623f23fb9a97fdd6b1a14acf0d970

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from sodiumjoe/dotfiles

CLAUDE.md CLAUDE.md file
sodiumjoe/dotfiles · CLAUDE.md
git:20260924.61ca4c1 · audit A · 49 stars
brainstorming SKILL.md skill
sodiumjoe/dotfiles · home/.agents/skills/brainstorming/SKILL.md · You MUST use this before any creative work - creating features, building components, adding functionality, or modifying…
v1.0.1 · audit A · 49 stars
dispatching-parallel-agents SKILL.md skill
sodiumjoe/dotfiles · home/.agents/skills/dispatching-parallel-agents/SKILL.md · Use when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies
v1.0.1 · audit A · 49 stars
executing-plans SKILL.md skill
sodiumjoe/dotfiles · home/.agents/skills/executing-plans/SKILL.md · Use when executing an implementation plan in the current session as the implementer yourself — your human partner chose…
v1.0.1 · audit A · 49 stars
finishing-a-development-branch SKILL.md skill
sodiumjoe/dotfiles · home/.agents/skills/finishing-a-development-branch/SKILL.md · Use when implementation is complete, all tests pass, and you need to decide how to integrate the work
v1.0.1 · audit A · 49 stars
neovim-review SKILL.md skill
sodiumjoe/dotfiles · home/.agents/skills/neovim-review/SKILL.md · Use when the user invokes /neovim-review for a pull request or a local :Review session in Neovim.
git:20260924.1820eae · audit A · 49 stars
neovim-rpc SKILL.md skill
sodiumjoe/dotfiles · home/.agents/skills/neovim/SKILL.md · Interact with a running neovim instance over RPC — open files, show diffs, execute Lua. Use when you need to open a…
git:20260924.1820eae · audit A · 49 stars
receiving-code-review SKILL.md skill
sodiumjoe/dotfiles · home/.agents/skills/receiving-code-review/SKILL.md · Use when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or…
v1.0.1 · audit A · 49 stars
requesting-code-review SKILL.md skill
sodiumjoe/dotfiles · home/.agents/skills/requesting-code-review/SKILL.md · Use when completing tasks, implementing major features, or before merging to verify work meets requirements
v1.0.1 · audit A · 49 stars
subagent-driven-development SKILL.md skill
sodiumjoe/dotfiles · home/.agents/skills/subagent-driven-development/SKILL.md · Use when executing implementation plans with independent tasks in the current session
v1.0.1 · audit A · 49 stars
systematic-debugging SKILL.md skill
sodiumjoe/dotfiles · home/.agents/skills/systematic-debugging/SKILL.md · Use when encountering any bug, test failure, or unexpected behavior, before proposing fixes
v1.0.1 · audit A · 49 stars
test-driven-development SKILL.md skill
sodiumjoe/dotfiles · home/.agents/skills/test-driven-development/SKILL.md · Use when implementing any feature or bugfix, before writing implementation code
v1.0.1 · audit A · 49 stars

Every file in sodiumjoe/dotfiles

Other files named using-superpowers

using-superpowers SKILL.md skill
obra/superpowers · skills/using-superpowers/SKILL.md · Use when starting any conversation - establishes how to find and use skills, requiring skill invocation before ANY…
git:20260919.5bf4e78 · audit A · 314,583 stars
using-superpowers SKILL.md skill
jnmetacode/superpowers-zh · skills/using-superpowers/SKILL.md · 在开始任何对话时使用——确立如何查找和使用技能,要求在任何响应(包括澄清性问题)之前调用 Skill 工具
v1.0.0 · audit A · 8,494 stars
using-superpowers SKILL.md skill
a5c-ai/babysitter · library/methodologies/superpowers/skills/using-superpowers/SKILL.md · Use when starting any conversation. Establishes how to find and use skills, requiring skill invocation before any…
git:20260601.da7723a · audit A · 1,896 stars
using-superpowers SKILL.md skill
coco-research/coco · skills/using-superpowers/SKILL.md · Use when starting any conversation - establishes how to find and use skills, requiring Skill tool invocation before ANY…
git:20260802.1479e32 · audit A · 797 stars
using-superpowers SKILL.md skill
xu123-bob/baize · agent/skills/superpowers/5.1.0/skills/using-superpowers/SKILL.md · Use when starting any conversation - establishes how to find and use skills, requiring Skill tool invocation before ANY…
git:20260912.5e131e8 · audit A · 617 stars
using-superpowers SKILL.md skill
vodailocz/kilo-kit-mcp · skills/productivity/using-superpowers/SKILL.md · Use when starting any conversation - establishes how to find and use skills, requiring Skill tool invocation before ANY…
git:20260502.38d5305 · audit A · 27 stars
using-superpowers SKILL.md skill
kalarislabs/skill-doctor · skills/using-superpowers/SKILL.md · Use when starting any conversation - establishes how to find and use skills, requiring skill invocation before ANY…
git:20260910.bd96e48 · audit A · 14 stars
using-superpowers SKILL.md skill
takaakit/superpowers-uml · plugins/superpowers-uml/skills/using-superpowers/SKILL.md · Use when starting any conversation - establishes how to find and use skills, requiring skill invocation before ANY…
git:20260804.eab20be · audit A · 12 stars

Browse by kind, by grade A, or by owner.