levels-help
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
Files1
View on GitHubSKILL.mdskills/levels-help/SKILL.md
GitHubLevels 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.mdand 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:
- Context. It looks at the project, then asks you only what it could not find.
- Audit. It states the level you are at now, with evidence, and lists the gaps.
- 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.
- Plan. It splits what you chose into small sub-plans.
- Delegation gate. It shows which model will do each sub-plan and asks before anything runs.
- Execution. The sub-plans run on the models you approved.
- 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 -->| Skill | Use it to |
|---|---|
levels |
Run several skills as one workflow |
levels-status |
See every level and open gap in one table |
levels-next |
Get the single best next step |
levels-help |
Read the guide |
idea-level |
Find or sharpen a project idea, up to a build-ready blueprint |
ux-level |
Check whether users can finish their tasks |
restyle-level |
See alternative looks and layouts as mockups |
design-level |
Raise the quality of the interface |
backend-level |
Harden the server, logic and edge cases |
data-level |
Fix stored data shape, integrity and migrations |
test-level |
Prove the product works |
security-level |
Find and close security weaknesses |
perf-level |
Measure and improve speed |
code-level |
Clean up structure without changing behaviour |
docs-level |
Make documentation accurate and usable |
ship-level |
Prepare a safe, repeatable release |
pitch-level |
Prepare a demo, talk or submission |
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.
auditorbuild:auditrates and proposes only.buildgoes on to plan and delegate the work.- A path or screen name: limits the skill to that area.
- Skill-specific switches: for example
a11yondesign-levelandrestyle-levelturns 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-levelwrites tests only,code-levelnever changes behaviour,restyle-levelnever 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-statuslists 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 theserver/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
auditmode. Inbuildmode, only after you pick options and approve the delegation gate. - Can I stop halfway? Yes. Progress is in
LEVELS.md. Run/levelsagain 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.