agentleFS
codezeroexecodezeroexe/levels/skills/levels-next/SKILL.md

levels-next

Skill3 starsChanged 32 days agoMITView on GitHub

Pick the single most valuable next step across all level skills for this project, explain why, and offer to start it. `levels` is the front door; this skill only recommends. Use when the user runs /levels-next or asks what to do next, where to start, or which level skill to run.

The file

We split this skill into the rules it gives an agent

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

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈3

    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
  1. Distinctive:

    Treat the arguments as the user's goal or deadline, if given.

    line 13
  2. Very specific:

    Read LEVELS.md in the project root if it exists: levels, targets, gaps, pending actions, dates, profiles.

    line 17
  3. Distinctive:

    If there is no goal in the arguments or the record, ask one question with AskUserQuestion: what is the user trying to reach, and by when.

    line 19
  4. Very specific:

    If there is no project yet, recommend idea-level.

    line 23
  5. Very specific:

    If the record shows an unfinished flow, recommend resuming levels unless a danger from rule 1 is open.

    line 46
  6. Distinctive:

    If every layer is at target and nothing is pending, say so and recommend stopping.

    line 48

≈ “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.

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

Levels next

Arguments: $ARGUMENTS

Treat the arguments as the user's goal or deadline, if given. This skill recommends and hands off. It does no auditing or building of its own.

Step 1: Read the situation

  1. Read LEVELS.md in the project root if it exists: levels, targets, gaps, pending actions, dates, profiles.
  2. Take a short look at the project: is there code, an interface, a server, stored data, tests, deploy files, documentation. Do not audit.
  3. If there is no goal in the arguments or the record, ask one question with AskUserQuestion: what is the user trying to reach, and by when.

Step 2: Choose

If there is no project yet, recommend idea-level.

If there is a project but no record, recommend the starting point by what exists: backend-level in audit mode for a product with an interface and a server (with design-level as the step after it), design-level or backend-level for one layer alone, code-level first for an inherited codebase the user does not yet understand.

Otherwise rank candidates by this order and take the first that applies:

  1. Danger already recorded. An open finding about data loss, an exposed secret or a critical security weakness. Run the skill that owns it.
  2. Waiting on the user. A pending live step or unanswered question blocks other work. Say what it is. No skill needs to run.
  3. Deadline. With a date close, the layer whose gaps would be seen or felt on the day: ship-level, then test-level, then pitch-level for an event or submission.
  4. Order between layers. A layer that others depend on comes first:
    • code-level before a large build that would land in tangled code.
    • test-level before restructuring or tuning untested code.
    • backend-level before design-level when the interface needs states the server does not report.
    • data-level before backend-level when the stored shape is the problem.
    • security-level and ship-level before anything is exposed to real users.
    • ux-level before design-level when users cannot finish a task.
    • restyle-level after ux-level and before design-level when the complaint is the look itself, not missing polish.
    • perf-level only after behaviour is correct and tested.
    • docs-level and pitch-level after the thing they describe has stopped changing.
  5. Distance. The layer furthest below its target.
  6. Never run. A layer relevant to this product with no row in the record.
  7. Stale. A layer whose record is older than the code it covers.

If the record shows an unfinished flow, recommend resuming levels unless a danger from rule 1 is open.

If every layer is at target and nothing is pending, say so and recommend stopping. Do not invent work.

Step 3: Recommend

Print:

  • Next: the skill, the mode and the arguments to run it with.
  • Why: one or two sentences tied to the record and the goal.
  • What it will cost: whether it starts an Opus audit, and whether it will ask questions first.
  • After that: the next two steps in order, one line each.

Then ask with AskUserQuestion: Start it (Recommended) / the second and third candidates, if there are any / Not now.

On a yes, invoke the chosen skill with the Skill tool, passing the goal and the relevant profiles so it does not ask again. One hop: the skill started here reports back and does not start another.

Rules

Recommend one thing, not a list of everything. Never recommend a higher target than the product needs. Never start a skill without the user's answer. If the chosen skill is missing from the skill listing, say so and offer the next candidate.

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.