skill-discovery
Skill1 starsChanged 19 days agoApache-2.0View on GitHub
How a recurring need is judged worth a skill, and how an existing skill is located. Not what a skill does once triggered (its own description) or how to structure a new skill file (see skill-creation).
14 other projects use a version of this.
Adopted by
Most recently taken up by
- HyperVon/agent-guidance-kittheir own version, first seen Nov 1, 2026
- wulaosiji/skillstheir own version, first seen Nov 1, 2026
- DentalEdge-Solutions/claude_codetheir own version, first seen Nov 1, 2026
- matthull/my-skillstheir own version, first seen Oct 20, 2026
- gabrielbchacon/ai-dev-bootstraptheir own version, first seen Oct 20, 2026
- EmeaAppGbb/spec2cloudtheir own version, first seen Oct 9, 2026
Used with
Projects with it also use find-skills, code-review and 1 more.
Other files people use alongside this one.
Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
VercelSkillfind-skills
Helps users discover and install agent skills when they ask questions like "how do I do X", "find a skill for X", "is there a skill that can...", or express interest in extending capabilities. This skill should be used when the user is looking for functionality that might exist as an installable skill.
Also in 3 projects that use this
GoogleSkillcode-review
Adversarial systems, concurrency, memory-model, and architecture code review protocol. Use this skill whenever asked to review code, PRs, diffs, or branches in Filament.
Also in 3 projects that use this
SentrySkillskill-creator
Create new agent skills following the Agent Skills specification. Use when asked to "create a skill", "add a new skill", "write a skill", "make a skill", "build a skill", or scaffold a new skill with SKILL.md. Guides through requirements, writing, registration, and verification.
Also in 3 projects that use this
Other versions14 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 14
- EmeaAppGbb/spec2cloud★ 100same name
- dannote/dot-pi★ 57same name
- wulaosiji/skills★ 28same name
- Samin12/skills★ 8same name
- L-yifan/skills★ 5same name
- crgarcia12/Liliput★ 4same name
- Roentek/Claude_Code_Boilerplate_Framework★ 4same name
- WupDev/skills_discovery★ 4same name
- DentalEdge-Solutions/claude_code★ 1same name
- HyperVon/agent-guidance-kit★ 1same name
4 more not listed
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository21 other files it gives its agents.
- AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- .github/copilot-instructions.mdCopilot instructions
- .cursor/rules/agents.mdcCursor rule
- commandsSkill
- daily-dashboardSkill
- daily-reviewSkill
- document-standardsSkill
- jotSkill
- merge-proxySkill
- monthly-reviewSkill
- orientSkill
- redaction-gateSkill
- session-closeSkill
- session-logSkill
- skill-creationSkill
- surface-regimesSkill
- technical-documentsSkill
- touchSkill
- weekly-reviewSkill
- working-preferencesSkill
The file
Files
When to Use
Two situations: deciding whether something that just came up repeatedly should become a skill instead of being handled once and forgotten, and figuring out which existing skill, if any, already covers a task before assuming none does or building a duplicate.
Worthiness Test
Score a candidate on four factors before building.
| Factor | Question |
| Frequency | Has this actually come up more than once, or is this the first time? |
| Reusability | Would the same content serve a different task later, or is this specific to what's happening right now? |
| Complexity | Is there enough structure here (rules, dials, checklists) to be worth formalizing, or is it a single fact? |
| Stability | Is this settled enough to write down, or still actively changing session to session? |
Rate each low, medium, or high. Don't build a numeric scale for a seven-skill family, that's precision the current scale doesn't need. A candidate scoring low on three or more factors is answered once and left in the conversation. A candidate scoring medium or above on at least three factors is a real skill candidate, run it through skill-creation.
Low frequency alone doesn't disqualify a candidate that's high on the other three. A rule this stable and this complex is worth capturing the first time it's articulated cleanly, waiting for repetition just means re-deriving it from scratch next time. Low stability is the harder disqualifier: a skill built on a rule still in flux gets stale before it's used, and a stale skill actively misleads in a way an unanswered question doesn't.
This is the missing piece under document-standards' Three-Tier Threshold Framework. That framework decides when a skill's reference material needs more structure. This decides whether a recurring need needs a skill at all. Different question, same standing-check spirit: re-evaluate per candidate rather than deciding once and reusing the verdict.
Locating an Existing Skill
Given the family's current size (the skills/ tables in README.md), discovery works by reading frontmatter description fields directly rather than through a dedicated routing file. Each skill's description already states what it covers and what it explicitly doesn't, with a pointer to whichever sibling does instead. The descriptions collectively function as the index.
Two failure modes worth checking for before concluding no skill covers something:
- Boundary drift. A skill's stated scope in its
descriptionno longer matches what it actually does, because the file was edited without the description being updated to match. Check the description against the actual sections, not just the description in isolation. - Split coverage. The need spans two skills' stated boundaries (a technical document authored under a specific surface regime touches
technical-documents,document-standards, andsurface-regimesat once). This isn't a gap, it's normal for skills that layer rather than replace each other. Confirm the layering is intentional (each skill's own trigger conditions, not a manual choice) rather than picking one skill and ignoring the others.
When Description-Matching Stops Being Enough
Reading each skill's description to find the right one doesn't need a dedicated gateway file. That overhead only starts paying for itself once there are enough skills in one category that scanning descriptions individually gets slow. One source project in this project's own research used four discover-* gateway files for eight downstream skills, roughly two skills per category. If this system's meta-skill category (this file, skill-creation, and whatever ends up adjacent to them) grows to three or more, revisit whether a dedicated discover-skill-standards gateway earns its place, rather than assuming the current description-matching approach scales indefinitely.
Scope Pointer
What a skill does once it's found and triggered is that skill's own content, not repeated here. How to structure a new skill file, once the Worthiness Test above says build one, is skill-creation's job.
<!--
SPDX-FileCopyrightText: 2026 Aidan Naveja
SPDX-License-Identifier: Apache-2.0
-->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.

