Manage skills
The catalog lives in ~/agent-skills. Read ~/agent-skills/docs/ARCHITECTURE.md before
structural changes.
- Which skill fits:
node ~/agent-skills/scripts/route.mjs "<request>"prints the ranked matches; the full list isdocs/SKILL-CATALOG.md. - Create or update a skill: extend an existing skill before adding one (check
registry/capabilities.jsonfor overlap). A skill isskills/<name>/SKILL.mdwithname,descriptionandmetadata(aliases,keywords,composes,requires,risk); long procedures go inworkflows/, material used by several skills inshared/. Then runnode scripts/build-registry.mjs,node scripts/validate.mjsandnode --test tests/*.test.mjs. - Adopt a third-party skill: it is untrusted code. Review it with
security-audit(third-party mode), pin the commit, record URL, commit, license and changes indocs/SOURCES.md, keep the license and notice files. Never auto-update or run unreviewed code. - Install or repair discovery:
node scripts/install.mjslinks every skill into~/.claude/skillsand~/.agents/skillsand prunes stale links it created.--dry-runshows the plan. The prompt router hook is opt-in:--router-hook on|off. Rollback is indocs/MIGRATION.md. - Learn from history: follow
~/agent-skills/history-learning/SKILL.md(consent per source, redaction first, every change reviewed).