finding-a-catalog-skill
Skill3 starsChanged 8 days agoMITView on GitHub
The directory of the thrillmade/agent-skills catalog — that catalog only, not the wider skills.sh ecosystem — naming every skill in it, what each one owns, and what it deliberately does not cover. Load it BEFORE authoring any rule, convention, checklist, standard, guideline or house style, and before saying "there is no skill for this" / "nothing covers X" / "I'll write the guidance" — including when the task looks too specific for an existing skill to exist, because a repo installs only the subset it subscribed to and absence from `.claude/skills/` is not absence from the catalog. Also load when choosing which sibling skill to open, when a skill routes you somewhere by name, when judging whether a proposed new skill duplicates one that exists, and when deciding what a repo is missing.
In this repository66 other files it gives its agents.
- AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- clud-bug-collaborationSkill
- critical-issues-onlySkill
- evidence-based-reviewSkill
- respect-existing-conventionsSkill
- skill-frontmatter-qualitySkill
- apca-contrastSkill
- api-contract-enforcementSkill
- brand-voice-reviewSkill
- chroma-harmonizationSkill
- clud-bug-collaborationSkill
- component-sizing-principlesSkill
- component-sizingSkill
- composing-a-screenSkill
- consuming-a-design-systemSkill
- conventions-templateSkill
- critical-issues-onlySkill
- curating-a-skill-catalogSkill
- designing-a-design-systemSkill
- designing-elite-uiSkill
- design-system-consistencySkill
- design-token-namingSkill
- dtcg-formatSkill
- empirical-design-principlesSkill
- evidence-based-reviewSkill
- frontend-a11ySkill
- guarding-a-regressionSkill
- ios-safari-surfacesSkill
- line-height-gridSkill
- logmindSkill
- motion-continuitySkill
- oklch-color-spaceSkill
- orchestrating-agent-delegationSkill
- orchestrating-a-multi-agent-runSkill
- orchestrating-elite-agent-qaSkill
- palette-relationshipsSkill
- pii-and-complianceSkill
- proving-an-absenceSkill
- respect-existing-conventionsSkill
- retiring-a-superseded-decisionSkill
- reviewing-design-workSkill
- semver-design-tokensSkill
- session-heartbeatSkill
- skillforgeSkill
- skill-frontmatter-qualitySkill
- spacing-systemSkill
- technical-writingSkill
- test-disciplineSkill
- thrill-designSkill
- token-frugal-toolingSkill
- token-naming-conventionsSkill
- type-scaleSkill
- udts-component-sizing-laddersSkill
- udts-dtcg-extensionsSkill
- udts-linter-rulesSkill
- udts-naming-conventionSkill
- udts-reviewSkill
- udts-semver-defaultsSkill
- udts-spacing-defaultsSkill
- The first 60 shown.
The file
We split this skill into the rules it gives an agent
4 rules. About 0 are common, 1 is distinctive, and 3 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈1
Distinctive · estimate
This author's own choices. Worth a look.
3
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Very specific: line 22
Every skill in the thrillmade/agent-skills catalog, grouped by what it owns.
- Distinctive: line 27
Read it before you write a rule: Before authoring a convention, a checklist, a house standard or a "how we do X" doc -- and before saying …
- Very specific: line 42
What this is not: Not a listing of your .claude/skills/ -- a repo holds only what it subscribed to, plus anything it authored locally -- …
- Very specific: line 160
Not being named above is not evidence of absence either.
≈ “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.
Files
Finding a catalog skill
Every skill in the thrillmade/agent-skills catalog, grouped by what it
owns. Generated from docs/placement-map.json and gated: add, rename or
delete a skill without regenerating and validate-skills fails, so this list
cannot go quietly incomplete the way a hand-kept table does.
Read it before you write a rule. Before authoring a convention, a checklist, a house standard or a "how we do X" doc -- and before saying "nothing covers this". The catalog is bigger than the set installed in any one repo, so not seeing a skill is not evidence that none exists. Check here first; that check is one read, and writing the guidance again is not.
What a line is. The fragment after each name says what that skill owns, not what it says -- editorial text, gated for presence and length but not for freshness against that skill's own body. Enough to shortlist two or three; then open them. A skill you do not have yet:
npx skills add https://github.com/thrillmade/agent-skills --skill <name>What this is not. Not a listing of your .claude/skills/ -- a repo holds
only what it subscribed to, plus anything it authored locally -- and not a
view of the wider skills.sh ecosystem. This indexes one catalog.
Reviewing a pull request
What a review flags, what it lets go, and what a claim has to cite.
api-contract-enforcement— public API shape changesbrand-voice-review— voice in user-facing stringscritical-issues-only— correctness, security, perf onlyevidence-based-review— quote the code or cut the claimguarding-a-regression— trusting a regression testpii-and-compliance— PII and secrets in logsproving-an-absence— claiming a thing is missingrespect-existing-conventions— a review is not a redesignskill-frontmatter-quality— judging a SKILL.md's frontmattertechnical-writing— docs and changelog for additionstest-discipline— test edits that hollow a suite
Running agents
Handing work out, gating what comes back, surviving a long session.
orchestrating-a-multi-agent-run— start here: the four obligationsorchestrating-agent-delegation— the brief, model tiering, verifyorchestrating-elite-agent-qa— the panel and design-critic gatesession-heartbeat— beats, checkpoints, resumingunattended-operation— what a handover permits
The catalog itself
Finding, censusing and authoring skills; decision logging; CLI conventions.
clud-bug-collaboration— living with the review botcurating-a-skill-catalog— the census rubric and verdictsfinding-a-catalog-skill— this directorylogmind— when and how to log a decisionretiring-a-superseded-decision— retiring a stale rulingtoken-frugal-tooling— quiet flags for the org's CLIs
Design: start here (L1)
Three entry points. Each routes to the primitives below in work order.
composing-a-screen— laying out a screenconsuming-a-design-system— using a system in a productdesigning-a-design-system— building or extending a systemreviewing-design-work— critiquing design output
Design primitives (L0)
Math and standards any design system can build on. No product opinions.
apca-contrast— Lc targets, the primary modelchroma-harmonization— per-stop cross-hue chroma capscomponent-sizing-principles— curated height and icon laddersdtcg-format— the W3C DTCG interchange fileempirical-design-principles— which design laws holdline-height-grid— two-track line height on gridmotion-continuity— motion between statesoklch-color-space— OKLCH ranges and gamut mappingpalette-relationships— hue-angle palette relationshipssemver-design-tokens— SemVer from the value diffspacing-system— minor+major units, 24px floortoken-naming-conventions— what belongs in a token nametype-scale— modular ratios and roundingusability-heuristics— what the heuristics saywcag-contrast— ratios, the legal cross-check
Web platform behaviour (L0)
What a shipping engine does that its spec and an emulator do not show.
ios-safari-surfaces— iPhone Safari bars, scroll, svh
Design review lenses (L0)
Judging the rendered surface -- and the standard it is judged against.
design-system-consistency— rendered drift from the tokensdesigning-elite-ui— the visual standard to build tofrontend-a11y— contrast, focus, targets, motionvisual-polish— the fine-but-not-elite lensweb-interface-guidelines-review— the code and markup lens
Design stances (L2)
One system's or one studio's lean on L0. The udts-* stubs are not guidance yet.
thrill-design— Thrill's house design tasteudts-component-sizing-ladders— per-density size laddersudts-dtcg-extensions— namespaced DTCG extensionsudts-linter-rules— machine-enforceable lint rulesudts-naming-convention— the concrete naming conventionudts-review— the system-specific lensudts-semver-defaults— SemVer policy choicesudts-spacing-defaults— density-mode spacing unitsudts-token-model— taxonomy and resolution
Deprecated (migration window)
Superseded. Each one names its successors; load those, not these.
component-sizing— use component-sizing-principlesdesign-token-naming— use token-naming-conventionsskillforge— use skill-creator / skill-smith
Templates
Copy-and-edit scaffolds. They fail the slug check until you customise.
conventions-template— a review-like-me scaffold
Deliberately not here
A map showing only what is inside teaches you the outside does not exist, which is the same mistake inverted. These are gaps this catalog knows it has. Each count is re-measured whenever this file is generated, over every skill's name and frontmatter description -- the surface that decides whether an agent finds it. A gap that had since been filled would refuse to render rather than go on advertising itself:
- TDD mechanics -- red before green, one failing test at a time. In the
superpowersplugin, not here --red before greenmatches 0 skills. - The same discipline under its other name --
test-drivenmatches 0 skills.
(Control: APCA matches 8, so the probe finds what is there.)
Not being named above is not evidence of absence either. Search skills/
before concluding a second time -- and control the search against a term you
know is there, the way the counts above are controlled.
Sources
- Published by thrillmot
- The catalog: https://github.com/thrillmade/agent-skills
- Placement, distribution and subscribers per skill:
docs/placement-map.json - The census that promotes, revises and retires these: https://github.com/thrillmade/agent-skills/tree/main/skills/curating-a-skill-catalog
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
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.

