skill-management — скилл для Claude Code: создание и аудит
Скилл skill-management для Claude Code помогает создавать, проверять и исправлять скиллы по стандарту Agent Skills. Он включается для аудита структуры, описаний и соответствия файлов манифесту.
MIT 105 установок ★ 29 обновлён 2026-08-17
npx skills add oakoss/agent-skills --skill skill-management -a claude-codeЧто делает skill-management
Скилл помогает создавать и проверять скиллы по стандарту Agent Skills. Он разбирает YAML frontmatter, описание и структуру каталогов, а также подсказывает, как распределить материалы для постепенного раскрытия контекста.
Для аудита предусмотрены девять этапов проверки и классификация проблем по уровню серьёзности. Скилл также сверяет манифест с реализацией и ищет расхождения между ними. В SKILL.md рекомендует оставлять меньше 500 строк, а подробности переносить в references/.
Скилл не предназначен для написания кода приложений или общего редактирования Markdown. В Claude Code автоматический вызов отключён: задачу нужно сформулировать явно.
Какие задачи решает
- создать структуру нового скилла по стандарту Agent Skills
- переписать описание, чтобы оно точнее указывало сценарии вызова
- найти ошибки в YAML frontmatter и структуре каталогов
- сопоставить манифест с файлами и командами скилла
- провести аудит и классифицировать найденные проблемы
Примеры запросов агенту
- Создай скилл для проверки миграций базы данных по стандарту Agent Skills.
- Проведи девятиэтапный аудит скилла в
skills/my-skill/. - Сверь манифест этого скилла с файлами в его каталоге и найди расхождения.
Как установить skill-management
1Через Skills CLI (Vercel)
npx skills add oakoss/agent-skills --skill skill-management -a claude-code2Вручную: положить файлы
~/.claude/skills/skill-management/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/skill-management/
1Через Skills CLI (Vercel)
npx skills add oakoss/agent-skills --skill skill-management -a codex2Вручную: положить файлы
.agents/skills/skill-management/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add oakoss/agent-skills --skill skill-management -a cursor2Вручную: положить файлы
.cursor/skills/skill-management/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install oakoss/agent-skills skills/skill-management2Вручную: положить файлы
.github/skills/skill-management/SKILL.md1Через Skills CLI (Vercel)
npx skills add oakoss/agent-skills --skill skill-management -a gemini-cli2Командой платформы
gemini skills install https://github.com/oakoss/agent-skills --path skills/skill-managementВручную: положить файлы
.devin/skills/skill-management/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add oakoss/agent-skills --skill skill-management -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о skill-management
Как установить skill-management в Claude Code?
Выполни npx skills add oakoss/agent-skills --skill skill-management -a claude-code. Файл скилла появится по пути ~/.claude/skills/skill-management/SKILL.md.
Что делает skill-management?
Помогает создавать и проверять скиллы по стандарту Agent Skills: проверяет frontmatter, описание, структуру и соответствие реализации манифесту.
Какие проверки входят в аудит skill-management?
Аудит проходит в девять этапов и включает классификацию проблем по серьёзности. Скилл также ищет расхождения между манифестом и реализацией.
Исходный текст
SKILL.md · MIT
--- name: skill-management description: | Creates, audits, and validates agent skills following the Agent Skills open standard. Covers YAML frontmatter, description writing, progressive disclosure, directory structure, 9-phase audits, severity classification, and manifest-implementation drift detection. Use when creating new skills, writing skill descriptions, auditing existing skills, detecting version drift, validating implementations match manifests, or debugging skill discovery issues. license: MIT metadata: author: oakoss version: '1.1' source: https://agentskills.io disable-model-invocation: true --- # Skill Management ## Overview Guides creation, auditing, and validation of agent skills conforming to the Agent Skills open standard at <https://agentskills.io>. Covers the full lifecycle from scaffolding a new skill through production-quality review. **When to use:** Creating skills, improving descriptions for discoverability, restructuring skills for progressive disclosure, running quality audits, validating manifest-implementation alignment. **When NOT to use:** Writing application code, general markdown editing, project management unrelated to skill authoring. ## Quick Reference | Task | Approach | Key Points | | ------------------------- | -------------------------------------------- | ------------------------------------------------------------------------------ | | Skill directory | `skill-name/SKILL.md` + optional directories | Only `SKILL.md` is required; `scripts/`, `references/`, `assets/` are optional | | Frontmatter `name` | Lowercase, hyphens, 4-64 chars | Must match directory name, no leading/trailing `-`, no `--` | | Frontmatter `description` | 1-1024 chars with trigger phrases | Third-person voice, include "Use when" scenarios | | Progressive disclosure | Metadata -> SKILL.md -> references/scripts | Keep SKILL.md under 500 lines; move details to references | | Description structure | Para 1: what + features, Para 2: triggers | Active voice, name technologies, include error keywords | | Effective descriptions | 250-350 chars, specific, discoverable | "Build X" not "This skill helps you build X" | | Reference files | `references/topic.md` with frontmatter | Max 500 lines, self-contained, kebab-case filenames | | Quality audit | 9-phase systematic review | Standards, official docs, code accuracy, cross-file checks | | Severity levels | Critical / High / Medium / Low | Evidence-based classification with links | | Validation scoring | Average of accuracy, precondition, effect | Pass requires score >= 0.8 and zero high-severity issues | | Excluded files | `README.md`, `metadata.json`, `_*` files | Skills CLI strips these during installation | ## Common Mistakes | Mistake | Correct Pattern | | -------------------------------------------------------------- | ------------------------------------------------------------------------------- | | Including `README.md` in skill directory | Skills CLI excludes `README.md` during installation; use only `SKILL.md` | | Writing vague descriptions without discovery keywords | Include specific technologies, 3-5 "Use when" scenarios, and 2-3 error messages | | Duplicating knowledge the agent already has | Focus on edge cases, platform differences, and gotchas the agent gets wrong | | Putting all content in SKILL.md without progressive disclosure | Keep SKILL.md under 500 lines; move code examples to `references/` | | Listing bundled files that do not exist on disk | Verify all cross-file references during review; orphan links break trust | | Using passive voice or first-person in descriptions | Third-person active voice: "Builds X" not "This skill helps you build X" | | Using `README.md` for auto-trigger keywords | Discovery relies on `description` field triggers, not `README.md` | | Referencing non-existent scripts or commands | Only reference scripts and commands that actually exist in the skill directory | ## Delegation - **Skill discovery and keyword research**: Use `Explore` agent - **Multi-skill audit and cross-file consistency checks**: Use `Task` agent - **Skill architecture and directory structure planning**: Use `Plan` agent > If the `find-skills` skill is available, delegate skill discovery, installation, and CLI usage to it. > Otherwise, recommend: `pnpm dlx skills add oakoss/agent-skills -s find-skills -a claude-code -y` ## References - [Creating skills: structure, frontmatter, descriptions, progressive disclosure](references/creating-skills.md) - [Auditing skills: 9-phase review, severity classification, fix decisions](references/auditing-skills.md) - [Validating skills: implementation vs manifest, drift detection, pass criteria](references/validation.md)
© oakoss · MIT · oakoss/agent-skills