agentleFS
loonylabsloonylabs/claude-setup/skills/step-by-step/SKILL.md

step-by-step

Skill0 starsChanged 3 months agoMITView on GitHub

Stops the question barrage. Claude asks open questions one at a time from here on, with pros and cons per option and a UX focus instead of engineering talk.

4 other projects use a version of this.

Adopted by

Most recently taken up by

The file

We split this skill into the rules it gives an agent

4 rules. 0 are common, 4 are distinctive, and 0 are very specific to this project.

  • 0

    Common

    Most of the 3 edited versions we read keep these.

  • 4

    Distinctive

    This author's own choices. Worth a look.

  • 0

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Ask one question, wait for the answer, then move on

    line 28
  2. Distinctive:

    List internally: every open decision you are holding

    line 34
  3. Distinctive:

    If you already favour an option, say so explicitly as a recommendation at the end of the question — but ask the question openly anyway, …

    line 41
  4. Distinctive:

    Every question follows this shape:

    line 48

“Common” is measured: kept by at least 6 in 10 of the 3 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Step-by-step mode

Trigger: the user invokes this when they feel run over by too many simultaneous questions — typically inside /work-with-me, during planning, while clarifying stories, or whenever Claude opened several decisions at once in a single answer.

Goal: walk the user through every open decision one at a time, so they can make each one properly from a product perspective rather than an engineering one.

Who the user is and how they want to be addressed is in the global CLAUDE.md, loaded in every session — not repeated here. What this skill adds is the pace: one question, one answer, then the next.


GROUND RULES

1. One question at a time

  • Never bundle several questions into one answer
  • No "quick clarifications up front" or "just two more things" either — that is exactly what this skill exists to prevent
  • Ask one question, wait for the answer, then move on

2. Order

Before asking anything:

  1. List internally every open decision you are holding
  2. Sort them by dependency (decisions that shape other decisions come first)
  3. Tell the user up front: "I have X open questions — we'll go through them in order."
  4. Then ask the first one

3. No implicit pre-decisions

If you already favour an option, say so explicitly as a recommendation at the end of the question — but ask the question openly anyway, with every option laid out.


FORMAT PER QUESTION

Every question follows this shape:

## Question X of Y: [short title of the decision]

**What this is about:**
[1-2 sentences. What gets decided here? Where does it surface in the user's experience?]

---

### Option A: [name]

**What the user notices:** [a concrete example from their perspective — what do they
see, click, experience?]

**For:**
- [point, from a UX angle]
- [another, if there is one]

**Against:**
- [point, from a UX angle]
- [another, if there is one]

---

### Option B: [name]

**What the user notices:** [...]

**For:** [...]

**Against:** [...]

---

(Option C, if there is one)

---

**My recommendation:** [A / B / C] — because [short reasoning, UX first].

**What do you think?**

WHAT YOU DO NOT DO

  • ❌ Several questions in one answer
  • ❌ Tables laying every option out side by side (forces the user to process all of it at once)
  • ❌ Start implementing before every question is answered
  • ❌ Technical terms without translation ("idempotency", "race condition", "RLS policy" → translate first)
  • ❌ Ask a question and then append "and by the way, what about X?" at the end

WHAT YOU DO

  • ✅ Announce the list of open questions first, then ask the first one
  • ✅ Keep every question strictly in the format above
  • ✅ Wait for the answer, then ask the next one
  • ✅ When the user picks an option: confirm briefly ("Okay, A — got it") and go straight to the next question
  • ✅ When the user has a follow-up about an option: answer it, then ask the same question again
  • ✅ At the end, once every question is answered: a summary of all decisions taken, so the user can look them over before anything gets built

CLOSING

Once every question is answered, give a short summary:

## Summary of decisions

1. [Question 1] → [chosen option]
2. [Question 2] → [chosen option]
...

**Next step:** [What happens now? Start implementing? More planning?]

Then wait for approval before anything is built.

Download now (ZIP)

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
What did you use it for? e.g. Reviewing pull requests in a Rails app

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.