agentleFS
dtiger1889-opsdtiger1889-ops/claude-harness-toolbox/skills/breakdown/SKILL.md

breakdown

Skill31 starsChanged 32 days agoMITView on GitHub

Decomposes one tangled problem into a smallest next action and a compact plan. Use only for /breakdown, "break this down", "break it down", or "decompose this". For open-ended ideation use fanout; skip when the task is already one clear action.

14 other projects use a version of this.

Adopted by

Most recently taken up by

Used with

Projects with it also use ship, implement and 1 more.

Other files people use alongside this one.

Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
  • AWSSkill

    ship

    Finalize dev work on an issue branch — update docs, push, and open a PR.

    Also in 3 projects that use this

  • Hugging FaceSkill

    implement

    Make tests pass. Invoke after /write-tests produces failing tests.

    Also in 3 projects that use this

  • MicrosoftSkill

    handoff

    Compact the current conversation into a handoff document for another agent to pick up.

    Also in 4 projects that use this

The file

We split this skill into the rules it gives an agent

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

  • 0

    Common

    Most of the 13 edited versions we read keep these.

  • 3

    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:

    Run inline without agents.

    line 8
  2. Distinctive:

    Read the supplied text or referenced artifact.

    line 10
  3. Distinctive:

    Use plain language and one critical path.

    line 18

“Common” is measured: kept by at least 6 in 10 of the 13 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

Breakdown

Run inline without agents. This is a planning request; execute only if the user also authorizes the work.

  1. Read the supplied text or referenced artifact. For project work, read the project's current state and instructions to EOF before choosing an action. Ask once if the problem is too vague to decompose.
  2. Respond with these five short blocks:
    • Goal: what completion means. Identify any discrepancy with the stated goal as an interpretation, not a settled fact.
    • Smallest next action: one concrete step that can be completed in one sitting.
    • Blocking decision: the fork that unlocks the action, or "none".
    • Full plan: a compact checklist, secondary to the next action.
    • First trap: the likeliest failure and its earliest observable signal.

Use plain language and one critical path. Do not create a file unless requested or required by the project's state-recording conventions.

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.