skills-discovery
Skills discovery — source of truth
Enforced when the opt-in guard hook is installed (see repo docs/hooks.md;
treat search-first as mandatory even without it). The hook
~/.claude/hooks/skills-discovery-guard.py runs on every
Bash call (PreToolUse) and denies (exit 2) raw enumeration of skill directories —
ls/find/tree against ~/.claude/skills, ~/.agents, ~/.cursor/skills,
~/.skills-archive, plugin caches, or bulk find -name SKILL.md / glob-cat of many
SKILL.md files. skillfind/rulesfind/build-index.py/skillserve.py are
allow-listed by name so the catalog's own tooling still works. This is the STRICT §3
rule (~/.ai/rules.md, propagates into AGENT_RULES.md + CLAUDE.md) — every agent
on this machine must comply, not just Claude Code.
Skills may live across many roots on this machine. NEVER enumerate them into context. Search first, read ONE SKILL.md.