Skill Audit — скилл для Claude Code: аудит каталога
Скилл Skill Audit для Claude Code проверяет, какие навыки вызываются и совпадают ли их описания с запросами. Он также ищет неиспользуемые навыки и повторяющиеся задачи без подходящего навыка.
MIT ★ 26 обновлён 2026-11-16
npx skills add wrg32786/aigent-os --skill skill-audit -a claude-codeЧто делает Skill Audit
Skill Audit собирает отчёт о работе каталога навыков. Он сортирует навыки по последнему вызову, считает запуски за 90 дней и отмечает кандидатов на удаление: неиспользуемые более 60 дней навыки с менее чем тремя вызовами.
Скилл сопоставляет слова-триггеры в описаниях с запросами, после которых агент вызывал навык. Ещё он группирует недавние запросы без вызова навыка, если вместо него использовались Read, Bash или Grep; кластеры от трёх случаев помечаются как возможные пробелы в возможностях. Для отчёта читает индекс навыков, папки навыков и журналы сессий. Их расположение зависит от установки: среди вариантов названы vault/daily/, ~/.claude/projects/ и логи хуков.
Результат — Markdown-отчёт с четырьмя разделами. Его можно сохранить в vault/memory/SKILL_AUDIT_<YYYY-MM-DD>.md.
Какие задачи решает
- найти навыки, которыми давно не пользовались
- сопоставить описания навыков с реальными запросами
- обнаружить повторяющиеся задачи без вызова навыка
- решить, какие навыки оставить, архивировать или удалить
Примеры запросов агенту
- Проведи аудит каталога навыков и собери Markdown-отчёт.
- Найди навыки, которые давно не вызывались, и предложи, что с ними сделать.
- Сравни описания-триггеры с запросами перед вызовами и найди пробелы в возможностях.
Как установить Skill Audit
1Через Skills CLI (Vercel)
npx skills add wrg32786/aigent-os --skill skill-audit -a claude-code2Вручную: положить файлы
~/.claude/skills/skill-audit/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/skill-audit/
1Через Skills CLI (Vercel)
npx skills add wrg32786/aigent-os --skill skill-audit -a codex2Вручную: положить файлы
.agents/skills/skill-audit/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add wrg32786/aigent-os --skill skill-audit -a cursor2Вручную: положить файлы
.cursor/skills/skill-audit/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install wrg32786/aigent-os skills/skill-audit2Вручную: положить файлы
.github/skills/skill-audit/SKILL.md1Через Skills CLI (Vercel)
npx skills add wrg32786/aigent-os --skill skill-audit -a gemini-cli2Командой платформы
gemini skills install https://github.com/wrg32786/aigent-os --path skills/skill-auditВручную: положить файлы
.devin/skills/skill-audit/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add wrg32786/aigent-os --skill skill-audit -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о Skill Audit
Как установить Skill Audit в Claude Code?
Выполни npx skills add wrg32786/aigent-os --skill skill-audit -a claude-code. Файл навыка находится по пути ~/.claude/skills/skill-audit/SKILL.md.
Что делает Skill Audit?
Он формирует Markdown-отчёт об использовании навыков, несовпадениях описаний с запросами и возможных пробелах в каталоге.
Какие данные Skill Audit использует для проверки?
Он читает индекс и папки навыков, историю вызовов и журналы сессий. Расположение журналов зависит от установки; среди указанных путей — vault/daily/, ~/.claude/projects/ и логи хуков.
Исходный текст
SKILL.md · MIT
--- name: Skill Audit description: "Audit skill usage and description-trigger fit. Use when finding unused skills, reviewing invocation history, or identifying missing capabilities." --- # Skill Audit Auditing the skill catalog itself. As the install grows from 5 skills to 50, the catalog goes from "I remember every skill" to "I have no idea what's in here." This skill makes the catalog legible to its owner. ## When to use - Once a quarter — hygiene pass - When the wrong skill is invoked repeatedly, or the right one never is (a description mismatch) - When a new feature feels like it should be a skill but you can't remember if you already built one - After importing a skill bundle from another principal (e.g., from a public aigent-OS release) - When considering retiring a project area and want to know which skills go with it ## What it produces A markdown report with four sections: ### Section 1 — All skills, sorted by last invocation ``` | Skill | Last used | Total invocations (90d) | Description | |---|---|---|---| | /open | today | 47 | Start session, load vault context | | /close | today | 47 | End session, commit memory | | /skill-recall | 5 days ago | 12 | Find the skill that fits a task | | /skill-name | 23 days ago | 3 | Example skill entry | | /old-experiment | 89 days ago | 1 | DEAD — flagged for retirement | ``` ### Section 2 — Dead skills (last used >60 days, <3 total invocations) These are candidates for retirement. List with: - Skill name + path - Last-used date - Total invocations - Recommendation: keep / archive / delete ### Section 3 — Description mismatch detection For each skill, compare the trigger words in its `description` (and `.claude/skill-index.json`, where kept) against the actual prompt patterns that preceded each invocation. Flag mismatches: ``` ⚠️ /channel-audit Triggers: "channel status", "YPP progress", "kill a channel" Actual prompts that led to invocation: "how are channels doing", "performance check", "review channels" Suggested words to ADD to the description: "performance check", "review channels", "how are channels doing" ``` ### Section 4 — Capability gaps Heuristic: scan recent prompts (last 30 days) where no skill was invoked and the principal manually invoked Read/Bash/Grep instead of a skill. Cluster by keywords. If a cluster has 3+ instances, flag as a capability gap. ``` 🆕 Possible missing skill: "weekly metrics rollup" Inferred from prompts: "weekly metrics", "this week's numbers", "rollup the week" Manual tools used: 4 Bash calls per occurrence Suggestion: codify as /weekly-rollup skill via /skills-builder ``` ## How to execute 1. Read the skill index and skill folder 2. Pull session logs / invocation history (location depends on install — check `vault/daily/`, `~/.claude/projects/`, hook output logs) 3. For each skill: count last 90 days of invocations, last invocation date 4. Build the four sections above 5. Output as markdown 6. Optionally: write report to `vault/memory/SKILL_AUDIT_<YYYY-MM-DD>.md` for trend tracking ## Why this skill exists Native skill matching only works if the catalog stays useful. Skills accumulate faster than they're retired. Trigger patterns drift from the principal's actual phrasing. Capability gaps go unnoticed for months. Skill audit is the corrective loop. ## Anti-patterns this prevents - Dead skills nobody has used in 6 months, spending the listing budget (noise) - Skills the principal needs going unmatched because their descriptions don't match how they actually phrase things - Re-building a skill that already exists (catalog isn't legible to the owner) - Frequently-manual workflows that should be skills but never get codified
© wrg32786 · MIT · wrg32786/aigent-os