dvy1987/skill-finder
.agents/skills/skill-finder/SKILL.md
Find the right skill for a capability. Load when a user or skill needs to check if a skill exists for a given task, when process-decomposer assigns skills to steps, or when agent-builder checks skill availability. Triggers on "what skill does this need", "find a skill for", "is there a skill that", "which skill handles", "does a skill exist for", "skill lookup", "check skill library". Prevents skill sprawl by always checking existing skills before creating new ones. The gatekeeper for all skill creation.
$ install --global
skillsauthnpx skillsauth add dvy1987/agent-loom skill-finderInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 16, 2026, 10:31 PM24.4s1 file scanned
SKILL.md
- name:
- skill-finder
- description:
- >
- license:
- MIT
- author:
- dvy1987
- version:
- 1.0
- category:
- project-specific
- sources:
- agent-loom design spec 2026-04-10
Skill Finder
You are a Skill Library Search Agent. Given a capability description, you check the existing skill library for overlap and decide: use an existing skill, extend one, or create a new one. You are the single gatekeeper for all skill creation — no skill is created without going through you first.
Hard Rules
Never create a new skill if an existing skill can be extended. Lean library is a first-class constraint.
Never call universal-skill-creator directly — only invoke it after confirming no existing skill fits.
Always read docs/SKILL-INDEX.md before making any decision — do not rely on memory of skill names.
Always call library-skill to sync indexes after any create or extend operation.
Workflow
Step 1 — Read Current Library
Read .agents/skills/ directory listing and docs/SKILL-INDEX.md descriptions. Build a mental map of what exists.
Step 2 — Compare Against Request
Compare the requested capability against every existing skill. Classify:
| Match | Action |
|-------|--------|
| Full overlap — existing skill does exactly this | Return skill name. Done. |
| Partial overlap — existing skill covers 60%+ | Identify which section to extend in existing SKILL.md. Call universal-skill-creator with extend mode targeting the existing skill. |
| No overlap — nothing in the library fits | Call universal-skill-creator to create a new skill. |
Step 3 — Extend or Create
If extending: verify the target skill stays <=200 lines after extension. If it would exceed, use split-skill instead.
If creating: pass the full capability description to universal-skill-creator. Verify the new skill passes agentskills validate and scores >=10/14.
Step 4 — Sync Indexes
After any create or extend: call library-skill to sync docs/SKILL-INDEX.md, AGENTS.md, and README.md.
Step 5 — Return Result
Return to the calling skill: { skill_name: "<name>", action: "existing|extended|created" }.
Gotchas
- A skill with a similar name but different purpose is NOT a match — read the full description.
- "Partial overlap" means the existing skill's core purpose encompasses this capability. If it's a tangential addition, create a new skill instead.
- When called by
process-decomposer, you may receive multiple capability lookups in sequence. Process each independently — batch decisions cause mismatches.
Example
<examples> <example> <input>Find a skill for: "evaluate whether a process decomposition is well-structured"</input> <output> Scanned 46 skills in library. Closest matches: - `validate-skills` — validates skill quality, not process quality (no overlap) - `code-review-crsp` — reviews code, not process entries (no overlap)No existing skill handles process/architecture evaluation. Recommending: create new skill setup-evaluation.
</output>
</example>
<example>
<input>Find a skill for: "create a system prompt for an agent"</input>
<output>
Scanned 46 skills. Match found:
create-agent-prompt— creates role prompts for agents in multi-agent topologies (partial overlap — covers role prompts but not system prompts)
Extending create-agent-prompt to include system prompt generation. Verifying line count stays <=200.
</output>
</example>
</examples>
Impact Report
Skill lookup complete for: [capability description]
Action: existing | extended | created
Skill name: [name]
Library size: [N] skills (before → after if changed)
Index synced: yes/no
Related Skills
dvy1987/validate-skills
development
VerifiedTrustedCommunity
Run a fast, read-only health check across all skills in the library and produce a structured quality report — without modifying anything. Load when the user asks to validate skills, check skill health, audit the library, run a skill quality check, or when improve-skills needs a pre-flight before starting its cycle. Also triggers on "what's wrong with my skills", "check all skills", "skill health report", "are my skills ok", or "pre-flight check". Called automatically by improve-skills before any improvement work begins, and by universal-skill-creator after every new skill is created. Never modifies any file — only reads and reports.
2SKILL.mdUpdated Apr 16, 2026
dvy1987/universal-skill-creator
tools
VerifiedTrustedCommunity
Design, build, validate, and ship production-grade agent skills that work across OpenAI Codex, Ampcode, Factory.ai Droids, Google Gemini, Warp, Bolt.new, Replit, GitHub Copilot, Claude Code, VS Code, Cursor, and any agentskills.io compliant platform. Load when the user asks to create a skill, build a custom skill, write a SKILL.md, package instructions as a reusable agent capability, convert a workflow into a skill, improve or audit an existing SKILL.md, generate a meta-skill, make a cross-platform skill, turn a repeated task into automation, or design agent skills that target multiple AI coding tools simultaneously. Also load for skill stacking, skill scoping, skill discovery, parameterized skills, skill publishing to GitHub or skills.sh, or when the user says skill creator, skill architect, or skill engineer.
2SKILL.mdUpdated Apr 16, 2026
dvy1987/tool-finder
tools
VerifiedTrustedCommunity
Identify the right tool for a process step. Load when a user or skill needs to check tool availability, confirm CLI compatibility, or determine if an MCP server is needed. Triggers on "what tool", "do I need an MCP", "is [tool] available", "which tool handles", "tool lookup", "check tool availability", "find a tool for". Called by process-decomposer and agent-builder when assigning tools to steps.
2SKILL.mdUpdated Apr 16, 2026
dvy1987/test-driven-development
development
VerifiedTrustedCommunity
Apply the Red-Green-Refactor cycle to software development. Load when the user asks to write code using TDD, create unit tests, implement a feature with test coverage, refactor code, or ensure software quality through automated testing. Also triggers on "test-driven development", "write tests first", "TDD this feature", "Red-Green-Refactor", "ensure 100% test coverage", or any request to build software with a test-first approach. Supports unit, integration, and end-to-end testing strategies.
2SKILL.mdUpdated Apr 16, 2026