Skills
Short cards that tell the agent how to approach a recurring kind of task. Data, never code — nothing here is executed.
Fewer cards, each with a name behind it. Every card here was reviewed by a maintainer before it merged, carries the provenance that review conferred, and is served with a hash of the exact bytes on this page. That is the part a catalogue of ninety thousand entries cannot offer.
10 cards
assert-what-the-generator-found
PatterncleanA generator that crashes tells you it failed; one that emits plausible output tells you nothing. Test what it found, never that it ran.
build-the-gate-before-the-content
PatterncleanA check added after the thing it guards is a check somebody switches off to ship. Wire it shut while there is nothing to block.
declare-when-a-setting-takes-effect
PatterncleanA control that saves successfully and changes nothing until a restart is worse than one that fails. Say when it applies, and derive that from where it is read.
derive-instead-of-transcribing
PatterncleanAnything copied by hand from another file is correct exactly once. If it can be generated, generate it and fail the build when the copy is stale.
do-not-ship-an-empty-surface
Anti-patterncleanAn empty screen, tab or category is a promise the product is not keeping. Hide it until it has content, or do not build it yet.
keep-the-caveat-with-the-number
PatterncleanA figure and its qualification must be one artifact. Two paragraphs drift apart; one component cannot.
pin-the-case-that-narrowed-the-rule
PatterncleanWhen a check fires on the wrong target, the fix makes it weaker. Capture the false positive as a test in the same commit, or the rule erodes silently.
publish-the-run-that-did-not-work
PatterncleanReport the experiment that failed, preserve the superseded one unchanged, and never re-roll for significance. Selection is the bias, not the number.
verify-before-claiming
PatterncleanBefore reporting a task as done, run the check that would fail if it were not — an explanation is not a fix.
warn-before-the-thing-you-are-warning-about
PatterncleanA caution placed after the action it concerns arrives after the reader has already decided. Put it above, and make it undismissable when it matters.
Contribute a card
Open a pull request against skills/ in the product repository. No issue needed — it is an open area, and reviewing a card is reading a page rather than auditing a diff.