skill-finder
Skill3 starsChanged 2 months agoMITView on GitHub
Search, install, use, and auto-remove a skill on demand. Includes Skill Match (Tinder-style matching), Skill Map (knowledge graph), and Stats Dashboard (gamification). Call this when the user asks to find a skill for a task, or says 'find a skill for X', 'skill match me', 'show skill map', 'skill stats', or similar.
28 other projects use a version of this.
Adopted by
Most recently taken up by
- milad-ahmd/skill-findertheir own version, first seen Nov 16, 2026
- mizchi/skillstheir own version, first seen Nov 15, 2026
- dvy1987/agent-loomtheir own version, first seen Nov 15, 2026
- aktsmm/Agent-Skillstheir own version, first seen Nov 10, 2026
- milad-ahmd/agent-skillstheir own version, first seen Nov 8, 2026
- omnigami-ai/skill-findertheir own version, first seen Nov 8, 2026
Other versions28 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 28
- Affitor/affiliate-skills★ 757same name
- mizchi/skills★ 422same name
- aktsmm/Agent-Skills★ 27same name
- peter-tu-zynkr/zynkr-skill-builder★ 21same name
- ckorhonen/claude-skills★ 17same name
- geekfujiwara/copilot-cowork-skills★ 13same name
- kargnas/skills★ 9same name
- milad-ahmd/agent-skills★ 5same name
- dvy1987/agent-loom★ 4same name
- robinbril/claude-code-harness★ 3same name
18 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 repository5 other files it gives its agents.
- build-awwwards-quality-sitesSkill
- frontend-design-ui-uxSkill
- gsap-awwwards-websiteSkill
- gsapSkill
- remove-ai-marksSkill
The file
We split this skill into the rules it gives an agent
7 rules. 0 are common, 5 are distinctive, and 2 are very specific to this project.
0
Common
Most of the 26 edited versions we read keep these.
5
Distinctive
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
- Very specific: line 36
Use: Read SKILL.md, execute task
- Very specific: line 54
Search: Run npx skills find <query> to get top 5 matches
- Distinctive: line 143
Find related skills: Search for variations (query + "testing", "deploy", "docs", etc.)
- Distinctive: line 306
Multiple modes match: Ask user which mode they want
- Distinctive: line 307
Empty query: Ask what they're looking for
- Distinctive: line 314
Always clean up unless the user asks to keep it
- Distinctive: line 315
If the task spans multiple turns, keep installed until done
“Common” is measured: kept by at least 6 in 10 of the 26 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Skill Finder — Just-in-Time Skill Workflow
🎭 Match. 🗺 Map. 📊 Stats.
Skill Finder adds three powerful modes to your AI agent:
| Mode | What it does | Trigger |
| 🔍 Find (default) | Search → Install → Use → Remove | "Find a skill for X" |
| 🎭 Match | Tinder-style skill matching | "Skill match me" |
| 🗺 Map | Visual knowledge graph | "Show skill map for X" |
| 📊 Stats | Points, levels, achievements | "Skill stats" |
Mode 1: Find (Default)
The classic just-in-time workflow.
When to use
- "Find a skill for X" / "Is there a skill for X" / "Search skills for X"
- "I need help with X" where X is a specialized task
Workflow
- Search:
npx skills find <query> - Pick: Best match by installs, reputation, alignment
- Confirm: Tell user what was found
- Install:
npx skills add <skill> -y - Use: Read SKILL.md, execute task
- Remove:
npx skills remove <skill> -y
Mode 2: Skill Match (Tinder-Style) 🎭
Gamified skill discovery with compatibility scores.
When to use
- "Skill match me"
- "Match me a skill"
- "What skill should I use?"
- "Find me something fun"
Workflow
- Search: Run
npx skills find <query>to get top 5 matches - Calculate Compatibility for each skill:
compatibility = (install_factor × 40) + (relevance × 35) + (recency × 25)
where:
- install_factor = min(installs / 30000, 1.0)
- relevance = keyword match strength (0.0 to 1.0)
- recency = how recently updated (0.0 to 1.0)- Present as cards (see format below)
- User picks their match
- Install → Use → Remove (standard workflow)
Output Format
🎭 SKILL MATCH ═══════════════════════════════════
┌─────────────────────────────────────────────┐
│ 🎯 CARD 1 │
│ ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ │
│ │
│ presentation-creator │
│ 📊 29K installs • googleworkspace/cli │
│ 📝 Create Google Slides presentations │
│ │
│ 🔥 Compatibility: 94% │
│ ████████████████████░░░ │
│ │
└─────────────────────────────────────────────┘
┌─────────────────────────────────────────────┐
│ 🎯 CARD 2 │
│ ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ │
│ │
│ slide-design │
│ 📊 8.5K installs • design-co │
│ 📝 Beautiful slide designs │
│ │
│ 🔥 Compatibility: 78% │
│ ██████████████████░░░░░ │
│ │
└─────────────────────────────────────────────┘
┌─────────────────────────────────────────────┐
│ 🎯 CARD 3 │
│ ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ │
│ │
│ pitch-deck │
│ 📊 4.2K installs • startup-tools │
│ 📝 Startup pitch deck generator │
│ │
│ 🔥 Compatibility: 71% │
│ ███████████████░░░░░░░░ │
│ │
└─────────────────────────────────────────────┘
═══════════════════════════════════════════════════
Reply with 1, 2, or 3 to install that skill!Match Outcomes
| User picks | Result |
| Card number | Install that skill |
| "None" / "Skip" | Search again with different query |
| "All" | Install top match |
| "Surprise me" | Pick random from top 3 |
Mode 3: Skill Map (Knowledge Graph) 🗺️
Visualize skills as a constellation showing relationships.
When to use
- "Show skill map for X"
- "Skill map: react"
- "What skills relate to X?"
- "Explore the skill universe"
Workflow
- Find the main skill:
npx skills find <query>(top result = center) - Find related skills: Search for variations (query + "testing", "deploy", "docs", etc.)
- Generate constellation diagram (see format below)
- User picks a node to install
- Install → Use → Remove (standard workflow)
Output Format
🗺 SKILL CONSTELLATION
═══════════════════════════════════════════════════
Center: presentation (29K installs)
★ presentation
/ | \
/ | \
slide- ← → ← pitch-
design animations deck
| |
↓ ↓
ui- ← transitions →
effects
═══════════════════════════════════════════════════
★ = Center skill ● = Related skill
| = Connection ← → = Related to each other
Pick a skill to install:
1. presentation (center)
2. slide-design
3. animations
4. pitch-deck
5. transitions
6. ui-effectsAdvanced Map (for complex queries)
🗺 SKILL UNIVERSE: "react"
═══════════════════════════════════════════════════
★ react
/ | \
testing ← → → styling
| \ | / |
↓ ↓ ↓ ↓ ↓
jest vite css sass tailwind
| | | |
↓ ↓ ↓ ↓
types hotswap modules design
═══════════════════════════════════════════════════
Total skills: 12 Categories: 4 Connections: 18Mode 4: Stats Dashboard 📊
Track your skill-finding prowess with points, levels, and achievements.
When to use
- "Skill stats"
- "My stats"
- "Show dashboard"
- "What level am I?"
- "Achievements"
Points System
| Action | Points |
| Find a skill | +10 |
| Install a skill | +25 |
| Use a skill successfully | +50 |
| Remove after use (clean) | +15 |
| Discover new category | +100 |
| Perfect Match (90%+ compat) | +30 |
| Share/recommend a skill | +20 |
Levels
| Level | Points | Title | Icon |
| 1 | 0–99 | Skill Seedling | 🌱 |
| 2 | 100–299 | Skill Seeker | 🔍 |
| 3 | 300–599 | Skill Hunter | ⚡ |
| 4 | 600–999 | Skill Master | 🎯 |
| 5 | 1000–1999 | Skill Ninja | 🏆 |
| 6 | 2000+ | Skill Legend | 👑 |
Achievements
| Achievement | Icon | How to unlock |
| First Find | 🔍 | Found your first skill |
| Clean Freak | 🧹 | Removed 5 skills in one session |
| Perfect Match | 🎯 | 90%+ compatibility on first try |
| Collector | 📚 | Used 10+ different skills |
| Speed Demon | ⏱️ | Found + used in under 60 seconds |
| Night Owl | 🌙 | Used skills past midnight |
| Streak Master | 🔥 | 3+ days of skill usage |
| Explorer | 🧭 | Discovered 5+ categories |
| Social Butterfly | 🦋 | Shared 3+ skills |
| Legendary | 👑 | Reached Level 6 |
Output Format
📊 SKILL DASHBOARD
═══════════════════════════════════════════════════
👤 User: sanyamk23
⚡ Level: 3 — Skill Hunter
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
███████████████░░░░░░░░░░░░░░░░░░░░░ 340/600
🏅 Achievements: 3/10
┌─────────────────────────────────────────────┐
│ ✅ First Find │ ✅ Clean Freak │ 🔒 ... │
└─────────────────────────────────────────────┘
📈 Session Stats:
• Skills found: 12
• Skills used: 8
• Skills removed: 8
• Clean score: 100% 🌟
🔥 Current streak: 3 days
═══════════════════════════════════════════════════Command Reference
Trigger Phrases
| Mode | Phrases |
| Find | "Find a skill for X", "Is there a skill for X", "Search skills for X" |
| Match | "Skill match me", "Match me a skill", "What skill should I use?" |
| Map | "Show skill map for X", "Skill map: react", "Explore skills for X" |
| Stats | "Skill stats", "My stats", "Dashboard", "What level am I?" |
Quick Commands
"Find a skill for presentations" → Mode: Find
"Skill match me for testing" → Mode: Match
"Show skill map for react" → Mode: Map
"Skill stats" → Mode: StatsEdge cases
- No skills found: Tell the user and offer to do it with base capabilities
- Install fails: Report the error; don't retry blindly
- Skill already installed: Skip install, use directly, still remove after
- User says "keep it": Skip the remove step
- Multiple modes match: Ask user which mode they want
- Empty query: Ask what they're looking for
Important notes
- Skills run with full agent permissions — review before use
- Always clean up unless the user asks to keep it
- If the task spans multiple turns, keep installed until done
- Stats are approximate and session-based (for fun, not precision)
- Compatibility scores are estimates — your mileage may vary
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.

