skill-discovery

Filesystem-first local skill lookup using lev-skills as the CLI and ~/.agents/skills-inventory.jsonl as the file-resolution source of truth.

This skill takes a task description and searches the local skills runtime. It resolves concrete SKILL.md files from the generated inventory at ~/.agents/skills-inventory.jsonl, built from the live filesystem under ~/.agents/skills + ~/.agents/skills-db, then enriches ranking with ~/.agents/skill-graph.json when graph metadata exists.

Operational Rule

When this skill is selected for a task, translate the user's intent into a short, broad search request before running local discovery:

lev-skills "<one sentence request with broad keywords>" --json --limit=5

Use returned local_path values to load the relevant SKILL.md files. Do not look for a skill-discovery binary; skill-discovery is the skill name, not the command.

Treat lev-skills as a basic lexical search over skill metadata, not semantic retrieval. Prefer clear nouns, verbs, product names, and known tool terms over chat phrasing. For example, turn "the CI is red after merge" into github actions ci workflow failure fix.

If the first query is weak, run a small query set instead of overfitting one sentence: