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

levels-help

Skill3 starsChanged 32 days agoMITView on GitHub

Explain the level skill set to a new user: what it is, which skill to start with, how a run goes, what the arguments mean and what it costs. Read-only and cheap. Use when the user runs /levels-help or asks how the level skills work, what they do or how to start.

The file

We split this skill into the rules it gives an agent

8 rules. About 0 are common, 4 are distinctive, and 4 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.

  • 4

    Very specific

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

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Read-only. This skill changes no file, spawns no agent and starts no other skill.

    line 13
  2. Distinctive:

    No argument: print Overview, then Start here, then Skills.

    line 15
  3. Distinctive:

    Use the skill names as the skill listing shows them (a name may carry a prefix).

    line 20
  4. Very specific:

    Every skill starts in audit mode unless you say build.

    line 45
  5. Very specific:

    Before any building starts you see a line such as Delegation: 6 sub-plans on Haiku, 2 on Sonnet.

    line 84
  6. Distinctive:

    No skill deploys, touches a live system or works on real data.

    line 90
  7. Very specific:

    Will it change my code?: Not in audit mode. In build mode, only after you pick options and approve the delegation gate.

    line 106
  8. Very specific:

    It asked for a level I do not understand: Run /levels-help <skill> to see that skill's five levels.

    line 109

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

Arguments: $ARGUMENTS

Read-only. This skill changes no file, spawns no agent and starts no other skill. Answer from the text below. Do not audit the project.

  • No argument: print Overview, then Start here, then Skills. End with the one-line list of topics.
  • Argument is a topic (overview, models, arguments, examples): print that section only.
  • Argument is a skill name: read that skill's SKILL.md and summarise it in at most twelve lines: what it audits, its five levels in one line each, its arguments, what it never does, and one example command. If the skill is not installed, say so.
  • A question in plain words: answer it from this text in a few sentences, then name the section to read for more.

Use the skill names as the skill listing shows them (a name may carry a prefix). If a skill named below is missing from the listing, mark it as not installed.

Overview

The level skills rate one part of a project on a scale from 1 to 5, show what is missing for the level you want, and then do the work if you ask. Every skill follows the same seven steps:

  1. Context. It looks at the project, then asks you only what it could not find.
  2. Audit. It states the level you are at now, with evidence, and lists the gaps.
  3. Options. For the main gaps it gives two or three choices with costs, and marks one as recommended. Then it stops and waits for you.
  4. Plan. It splits what you chose into small sub-plans.
  5. Delegation gate. It shows which model will do each sub-plan and asks before anything runs.
  6. Execution. The sub-plans run on the models you approved.
  7. Review. It checks the result and reports what moved and what is still open.

Level 5 is not the goal. Pick the level that fits the product. A small tool is finished at level 2 or 3, and the skills will tell you when a target is too high.

Results are kept in LEVELS.md in the project root, so later skills do not ask the same questions again.

Start here

  • First time, or not sure: run /levels. It asks what you want to do with a tick-box prompt and runs the right skills in a safe order.
  • Just want to see where the project stands: /levels-status.
  • Want one recommendation: /levels-next.
  • Know exactly which part you want: run that skill directly, for example /test-level.

Every skill starts in audit mode unless you say build. An audit changes nothing in your product code, so it is always safe to run first.

Skills

<!-- skills-table:start -->
SkillUse it to
levelsRun several skills as one workflow
levels-statusSee every level and open gap in one table
levels-nextGet the single best next step
levels-helpRead the guide
idea-levelFind or sharpen a project idea, up to a build-ready blueprint
ux-levelCheck whether users can finish their tasks
restyle-levelSee alternative looks and layouts as mockups
design-levelRaise the quality of the interface
backend-levelHarden the server, logic and edge cases
data-levelFix stored data shape, integrity and migrations
test-levelProve the product works
security-levelFind and close security weaknesses
perf-levelMeasure and improve speed
code-levelClean up structure without changing behaviour
docs-levelMake documentation accurate and usable
ship-levelPrepare a safe, repeatable release
pitch-levelPrepare a demo, talk or submission
<!-- skills-table:end -->

Arguments

Arguments go after the command, in any order.

  • A number 1 to 5: the level to aim for. Each skill has its own default.
  • audit or build: audit rates and proposes only. build goes on to plan and delegate the work.
  • A path or screen name: limits the skill to that area.
  • Skill-specific switches: for example a11y on design-level and restyle-level turns accessibility requirements on. They are off unless you ask. Run /levels-help <skill> to see the switches for one skill.

Models

  • Opus (or Fable, if your session runs it) does the thinking: context, audit, options, plan and review.
  • Haiku or Sonnet does the building. Haiku is the default. Sonnet is used where the work cannot be fully written out in advance.
  • Before any building starts you see a line such as Delegation: 6 sub-plans on Haiku, 2 on Sonnet. Review on Opus. and four choices: as planned, Haiku only, Sonnet for all, or no delegation.
  • Nothing builds until you answer. Each skill started by another skill asks again, because it starts its own spend.
  • To spend least: run audits only, choose few gaps, and keep the level modest.

Safety

  • No skill deploys, touches a live system or works on real data. Steps on a live system are written out for you to run.
  • Skills stay in their own area. test-level writes tests only, code-level never changes behaviour, restyle-level never edits product code.
  • One skill may offer to start another when it finds a problem outside its area. It always asks first.
  • Accepted risks and steps waiting on you are recorded in LEVELS.md. /levels-status lists them.

Examples

  • /levels: answer the prompt, confirm the level plan, approve each skill as it comes up.
  • /levels release: tests, security, documentation and release checks before a date.
  • /design-level 3 audit: rate the interface against level 3 and list the gaps.
  • /backend-level 4 build server/: audit the server/ folder, then plan and build to level 4.
  • /restyle-level 2 4: four alternative directions, each as one first screen.
  • /idea-level: brainstorm project ideas from your constraints.

Common questions

  • Will it change my code? Not in audit mode. In build mode, only after you pick options and approve the delegation gate.
  • Can I stop halfway? Yes. Progress is in LEVELS.md. Run /levels again to resume.
  • Do I need every skill? No. Skip what does not apply. The skills say so when a requirement does not fit the product.
  • It asked for a level I do not understand. Run /levels-help <skill> to see that skill's five levels.
  • A skill is missing. The others still work. Handoffs to a missing skill stop and tell you.

Topics: overview, models, arguments, examples, or any skill name.

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.