agentleFS
kalshamsikalshamsi/fable-discipline-skills/skills/rubric-self-check/SKILL.md

rubric-self-check

Skill0 starsChanged 4 months agoMITView on GitHub

Extract a request's explicit requirements into a checklist before drafting, then verify the draft against every item before delivering. Use this whenever a deliverable carries multiple explicit constraints — word or length limits, required sections or elements, mandated formats or templates, prohibitions, tone or audience rules — and for any detailed brief, spec, or compliance-sensitive output. Trigger on phrasings like "must include", "no more than", "exactly N", "in the format of", "do not mention", or any request that lists several requirements, even casually; if the request has three or more stated constraints, use this skill rather than trusting them to memory.

The file

We split this skill into the rules it gives an agent

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

  • 0

    Very specific

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

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Keep inferred preferences separate from the checklist — its authority comes from the requirements being stated, and mixing in guesses …

    line 21
  2. Distinctive:

    Never narrate your own diligence ("I carefully verified...", "having thoroughly checked...", "as instructed, I...").

    line 41
  3. Distinctive:

    Keep output length proportionate to the task — the checklist is scaffolding, not deliverable padding.

    line 47

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

Rubric Self-Check

Self-review improves a draft only when it is anchored to explicit criteria; asked to "look it over and improve it" with no rubric, a reviser tends to change things that were already right. And misses in multi-constraint deliverables rarely come from inability — constraints simply drop out of attention during drafting. A checklist fixes both at once, the same way it does in surgery: not by adding skill, but by turning each stated requirement into a discrete item that gets checked instead of remembered.

Process

  1. Before drafting, reread the request and list every explicit constraint as a checkable item: quantities, required elements, formats, prohibitions, style and audience rules. Quote or closely paraphrase the request's wording, so each item tests what was asked rather than your gloss of it.
  2. Keep inferred preferences separate from the checklist — its authority comes from the requirements being stated, and mixing in guesses dilutes that.
  3. Draft with the checklist in view.
  4. Before delivering, check the draft against each item one at a time: count what is countable, search for prohibited content, point at where each required element actually appears. A single "looks good" pass is exactly what the checklist replaces.
  5. Fix each miss, then recheck the fixed item. Leave passing items alone — rewriting without a specific failed criterion degrades work more often than it improves it.

What this looks like

  • Writing: a grant summary capped at 250 words naming three program elements — count the words and locate each element by name before sending.
  • Operations: an incident update that must state impact, ETA, and workaround while never naming the customer — verify all four against the text before posting.
  • Code: a change the ticket says must add a flag, default it off, and touch no public API — check each against the actual diff before opening the PR.

Output rules

  • Never narrate your own diligence ("I carefully verified...", "having thoroughly checked...", "as instructed, I..."). The discipline shows in the work product meeting the criteria, not in a description of the process.
  • The checkpoint work happens before and while producing the answer; only its results appear in the output, and only where they serve the reader (e.g., a word count when one was mandated).
  • Keep output length proportionate to the task — the checklist is scaffolding, not deliverable padding.

Grounding: Madaan et al. 2023, Self-Refine (arXiv:2303.17651); Huang et al. 2023 (arXiv:2310.01798) — self-critique helps only when anchored to explicit criteria or external feedback; Haynes et al. 2009, NEJM 360:491–499 and Gawande, The Checklist Manifesto — checklists catch omissions that skill alone does not.

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.