steps
Skill1 starsChanged 33 days agoMITView on GitHub
End a response with an ordered, copy-pasteable who-does-what checklist, rationale dropped. FIRE PROACTIVELY whenever a response leaves the user work the CLI cannot or will not do (dashboard-only setting, OAuth login, DNS record, secret paste, starting the local dev stack, destructive git they must confirm). Also after /recommend or before /handoff. NOT /recommend (that picks the move; this lists steps already decided).
- Reads credentials
- Installs packages
1 other project uses a version of this.
Adopted by
Most recently taken up by
- osteel/agent-skillstheir own version, first seen Oct 13, 2026
Other versions1 project uses a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 1
- osteel/agent-skills★ 3same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository56 other files it gives its agents.
- autopilotSkill
- before-afterSkill
- bigpictureSkill
- blast-radiusSkill
- brainstormSkill
- compoundSkill
- confidence-checkSkill
- contextualizeSkill
- create-ship-skillSkill
- create-skillSkill
- curateSkill
- debugSkill
- deep-researchSkill
- devtoolsSkill
- distillSkill
- done-checkSkill
- doneSkill
- double-checkSkill
- envsetSkill
- explainSkill
- fortifySkill
- goSkill
- handoffSkill
- harness-auditSkill
- interviewSkill
- matrixSkill
- mockupSkill
- mutateSkill
- notesSkill
- postmortemSkill
- presentSkill
- qaSkill
- readableSkill
- recommendSkill
- reportSkill
- retireSkill
- review-planSkill
- scoutSkill
- sec-reviewSkill
- setup-ticketingSkill
- setup-worktreesSkill
- spec-checkSkill
- specSkill
- successionSkill
- super-reviewSkill
- tangentSkill
- tddSkill
- tend-memorySkill
- testSkill
- ticketSkill
- tldrSkill
- triageSkill
- waitSkill
- workSkill
- worth-itSkill
- wrap-upSkill
The file
We split this skill into the rules it gives an agent
7 rules. About 0 are common, 4 are distinctive, and 3 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈4
Distinctive · estimate
This author's own choices. Worth a look.
3
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 43
All the user's:
- Distinctive: line 69
Add a context sub-line when it changes how the user executes — a gotcha, a "why this matters," a "watch out for" hint, a dependency on a …
- Distinctive: line 70
Don't nest deeper than one level.
- Very specific: line 75
Inline dependency context: When a user step depends on something Claude completed (e.g.
- Very specific: line 76
No fabrication: If the prior response laid out no pending steps for either actor (it was pure explanation, code, or analysis), say so …
- Distinctive: line 78
Preserve execution order: If the prior response laid the steps out in a specific order (dependencies, prerequisites), keep that order.
- Very specific: line 82
If the user added a focus below, narrow to just that slice (e.g.
≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Pull the steps that move the work forward out of the prior response and lay them out as a clean checklist: what the user does, what Claude does, in what order. Assume the prior response interleaved instructions with explanation, rationale, and aside-commentary — strip all of that and surface just the do-this list.
The list covers both actors, not just the user's half: in a mixed sequence (you, you, me, you) the order across actors is exactly what gets lost on a context switch.
When to fire this WITHOUT being asked
The user should not have to type /steps to get the to-do list out of a wall of prose. Fire it yourself whenever a response ends with work on their side, specifically:
- The CLI genuinely cannot do it — a vendor dashboard that refuses API writes (probe first; the refusal is the evidence), an interactive OAuth login, a registrar DNS record, entering a payment card, a real-browser check headless can't fake.
- The CLI will not do it, by a rule the user set — a secret only they can paste (through a no-echo entry flow, never into chat), starting a dev server they run themselves, a destructive or irreversible git operation needing their confirmation, an outward-facing push they haven't cleared.
Two judgment calls that keep this from becoming noise:
- One step is not a checklist. A single obvious action ("click Create token") stays inline prose. Reach for the list at roughly two or more steps, or one step with real gotchas.
- Don't split the response. The steps go at the END of the substantive answer, not instead of it. The user still wants the reasoning; they just shouldn't have to mine it for the to-do.
The trigger is still work on the user's side. A sequence that is entirely Claude's and needs nothing from them is not a reason to stop and print a list — do the work.
Whose step
- Unlabelled means all the user's. Most lists are entirely theirs; leave them bare.
- The moment any step is Claude's, label every step —
**You** — …for the user,**Me** — …for Claude. Same convention as/report's Next section. - One actor per step. A "together" action splits into its two halves, in order:
**You** — trigger the loginthen**Me** — read the server log for that request. - A Me step belongs in the list only if it has to wait — on a You step, on their confirmation, or on their go-ahead. Work Claude can do right now with nothing from them isn't a step: do it first, then fold the result into the You step that depends on it (see Inline dependency context).
- Say what a waiting Me step waits for. That is the hand-back point — it tells the user what to say to get Claude moving again.
Output shape
Plain numbered list, imperative voice. One sub-line of context allowed per step, only when it aids execution.
All the user's:
1. Open Vercel → Project X → Settings → Env Vars and add `STRIPE_SECRET_KEY`
- Copy the value from local `.env` — don't paste it into chat
2. Trigger a redeploy from the Deployments tab
- Vercel only picks up the new env var on next build
3. Confirm the build by checking the `Environment` panel for `STRIPE_SECRET_KEY`
4. Run `supabase db push` locally to sync the migration to the hosted DBMixed:
1. **You** — Mint a Railway token (Account → Tokens) and store it as `RAILWAY_TOKEN` in `.env`
- Don't paste the value into chat
2. **Me** — Deploy the staging service and read its health check back, once you say the token is in
3. **You** — Open the staging URL in a real browser and confirm Google login completes
- Headless can't pass Google's bot check
4. **Me** — Promote staging to prod after you confirm step 3Rules for each step:
- Imperative voice ("Open X", "Run Y", "Paste Z"). Lead with the verb.
- Inline the exact value, path, command, URL, or name the step needs — the user shouldn't have to scroll back up to find it.
- Preserve code formatting: shell commands, file paths, env var names, and identifiers stay in backticks or fenced code blocks.
npm installreads very differently from npm install when scanning to copy-paste. - Add a context sub-line when it changes how the user executes — a gotcha, a "why this matters," a "watch out for" hint, a dependency on a prior step. Skip it when the action speaks for itself; not every step needs one.
- Don't nest deeper than one level.
Rules
- Only what's still to do. Drop anything Claude already did — it appears only as context on the step that depends on it. Which of Claude's pending actions qualify, and how they're labelled: see Whose step.
- Inline dependency context. When a user step depends on something Claude completed (e.g. "I pushed
feature-x— you open the PR"), fold that context into the step itself:Open the PR for \feature-x` at<URL>`. Otherwise the checklist reads as instructions floating in a vacuum. - No fabrication. If the prior response laid out no pending steps for either actor (it was pure explanation, code, or analysis), say so plainly:
No steps in the prior response — it was [explanation / code / analysis].Don't invent steps to fill the format. - Trim the rationale, keep the load-bearing bits. Drop verbose asides, alternative paths the user isn't taking, and post-hoc commentary. Keep the anchoring context that makes a step actually executable — the gotcha, the constraint, the thing that explains why this step is shaped this way. Lean, but not stripped to the bone.
- Preserve execution order. If the prior response laid the steps out in a specific order (dependencies, prerequisites), keep that order. If the order was incidental, use whatever order makes the work flow naturally.
- No preamble, no signoff. Skip "Here are your steps..." / "Let me know if...". Just the list.
- Don't fire after
/report./report's Next section already emits this shape inline; running/stepson it just duplicates the list.
If the user added a focus below, narrow to just that slice (e.g. /steps deployment → only the deploy-related steps): $ARGUMENTS
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

