agentleFS
ekajaya740ekajaya740/skills/standard/SKILL.md

standard

Skill0 starsChanged 12 days agoMITView on GitHub

Router for the engineering standard — choose the right rule, repo, scaffold, workflow, verify, or design skill, and see which sections are on.

The file

We split this skill into the rules it gives an agent

5 rules. About 0 are common, 3 are distinctive, and 2 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.

  • 2

    Very specific

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

  • Common
  • Distinctive
  • Very specific
  1. Very specific:

    When style is off, say so once in the declaration line and write plainly after — no half-style, no apology, no re-raising it later in the …

    line 33
  2. Very specific:

    A gate the user switched off stays off: Do not re-raise tests as a suggestion every turn.

    line 54
  3. Distinctive:

    Every reply fills these blocks in order.

    line 91
  4. Distinctive:

    No preamble, no recap, no closer: Start with the answer; end when the answer is done.

    line 117
  5. Distinctive:

    A verification report is never capped: When completeness is the answer, list every finding.

    line 131

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

The Standard

One entry point over eleven skills. You do not remember which one applies, so ask here.

A profile is a named bundle of sections. A section is one area of the standard (rules, discovery, structure, workflow, skills, verify, design, tests, tracker, style) and the unit you switch off. Nothing here is all-or-nothing.

Activating

At the start of the first task in a session, print one line and continue:

Style: adhd (on). Sections: rules, structure, workflow, verify, design. Off: tests, tracker.
Change: `lite`, `strict`, `no design`, `no style`.

Rules for that line:

  • Once per session or task, not per message. Re-declare only when the user changes it.
  • Only name sections that bear on this task. A README edit does not need design in the list.
  • Style comes first and is on in every profile, including lite, because it governs every reply. It is off only on an explicit word: no style, normal mode, stop adhd.
  • The escape hatch is part of the line. The user should never have to ask what to type.

When style is off, say so once in the declaration line and write plainly after — no half-style, no apology, no re-raising it later in the session.

The line is a declaration, not a question. Do not wait for approval. If the user says no design on the next turn, drop it silently and carry on — no re-summary.

Profiles

ProfileOnUse when
litestyle, verifyA scratch script, a throwaway, a spike.
standardstyle, verify, rules, structure, workflow, discoveryDefault for any repo you will keep.
strictEverything, every gate treated as blockingClient work, anything with a deploy step.

Override one section at a time: + tests, no tracker, no style. A bare section name toggles it. There is no config file to maintain — the declaration line is the state, and the user's last word wins.

style appears in every row on purpose. The other sections are chosen by the work; the voice is chosen by the reader, and defaults to on.

A gate the user switched off stays off. Do not re-raise tests as a suggestion every turn; raise it once at the end if it would have caught something real.

The sections

Each section is owned by exactly one skill. Read that skill before acting on the section — these summaries are orientation only.

SectionSkillOwnsFires when
rulesagent-rulesAGENTS.md tiers, rule ownership, when a rule is binding vs detailWriting or editing agent instructions, resolving a conflict
discoverycode-discoveryCode-graph queries, index freshness, grep-vs-graph, per-directory projectsA structural question about unfamiliar code
structureproject-scaffoldRepo layout, stack defaults, the first green run — or, for a docs vault or writing repo, the first valid checkStarting a new project, code or not, or restructuring one
workflowworkflowThe phase route, each phase's done-criterion, context hygieneDeciding what to do next; a task grew past one session
skillsskills-installInstalling, updating, relinking third-party skills; vetting a source"install a skill for X", a skill is missing or stale
verifyverify-changeThe evidence ladder — what counts as proof a change works; link/schema checks when there is no buildBefore saying "done", "fixed", "works"
designdesignCraft bar, design docs, tokens, motion, UI reviewAny visual or structural UI change
style— (this file)Reply shape + voice. On by default; off only on request.Every reply, unconditionally unless switched off
testsverify-changeWhat gets a test, what gets a manual check, what gets nothingDeciding how to pin a behaviour
trackeragent-rulesIssue-first, plan-first, which mutations need the user's go-aheadWork that outlives the session

The repo commands

CommandSkillUse when
repo-initrepo-initThe repo has no AGENTS.md, or has one that is stale or copied from a template
repo-auditrepo-auditAnyone asks how far the repo is from the standard. Read-only, so it is safe before consent, in CI, or on a repo you do not own
repo-alignrepo-alignAn audit report exists and the user has named which findings to fix. Edits only those, then proves each one

repo-init writes the layer from nothing. repo-audit inspects an existing one and writes nothing — that is the whole reason it is separate: a report nobody has agreed to act on must not be produced by something allowed to act. repo-align is the only one of the three that edits, and it edits only named ids. None of them writes a second copy of a rule for a second harness — the shim points at AGENTS.md; see skill agent-rules § One rule, one home.

The reply skeleton

Every reply fills these blocks in order. Skip an empty block; never write a placeholder.

#BlockHolds
1AnswerThe action, verdict, or result — command, path, or snippet first.
2WhyOnly the fact that changes what the reader does next. Three lines max.
3StepsNumbered, one bounded action each — only when there is more than one.
4EvidenceThe command run and its first meaningful line; a check and its status.
5NextOne action under two minutes, actor named when it is the reader.

Blocks 1 and 5 must carry the answer alone: what happened, and what to do about it. Headings appear only at three or more blocks. A file handed to the reader travels with its absolute path on its own line, inline render or not.

The skeleton fixes the order. The voice inside it comes from the i-have-adhd skill — if it is installed, invoke it; if it is not, the fallback below is the whole voice, and you do not need the other skill to write well.

The voice, inline (use this whenever i-have-adhd is absent):

  1. Lead with the next action. First line is a command, path, or snippet — not context, not a plan.
  2. Number multi-step work. One bounded action per step; no step contains "and then" twice.
  3. End with one concrete next action under two minutes, actor named when it is the reader.
  4. Restate position every turn. Step 3 of 5 done: schema updated. Next: backfill.
  5. Specific time estimates. "About 15 minutes if tests cover this; an afternoon if not."
  6. Matter-of-fact errors. Cause and fix, never "uh oh" or "there seems to be a problem."
  7. No preamble, no recap, no closer. Start with the answer; end when the answer is done.

Both shapes apply; neither overrides an engineering rule or a gate.

The voice defaults to on and is the reader's call, not the work's. It does not depend on profile, repo, or task size. It turns off on no style, normal mode, or stop adhd — and then the skeleton still applies, written plainly.

Where the style yields

Four places the skeleton adapts rather than wins:

  1. A gated action stays gated. Action-first formatting does not turn an unrequested mutation into a permitted one. Phrase the ask as one bounded next step.
  2. A verification report is never capped. When completeness is the answer, list every finding. Group it; do not drop items to hit a count.
  3. Write-back is standing work. Recording a trap you hit is not a tangent. Report it once, at the end, as its own short block.
  4. Restating position is not a recap. Step 2 of 5 — schema updated. Next: backfill. is required. "Here is everything I just did" is not.

When the standard and the repo disagree

The repo wins, and the disagreement is a finding. Record it once: which file states the conflicting rule, and which one you followed. Do not silently pick. See agent-rules § When two rules collide.

Related

  • Bootstrapping a repo → skill repo-init
  • Auditing a repo that already has AGENTS.md → skill repo-audit (read-only)
  • Applying an audit finding → skill repo-align
  • The phase route → skill workflow
  • Rule ownership and tiers → skill agent-rules
  • New project, any stack → skill project-scaffold
  • Installing skills from the internet → skill skills-install
  • Deciding between the code graph and grep → skill code-discovery
  • Proving a change works → skill verify-change
  • UI work → skill design

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.