К основному содержанию
скилл CX Codex

skill-management — скилл для Claude Code: создание и аудит

Скилл skill-management для Claude Code помогает создавать, проверять и исправлять скиллы по стандарту Agent Skills. Он включается для аудита структуры, описаний и соответствия файлов манифесту.

MIT 105 установок ★ 29 обновлён 2026-08-17

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add oakoss/agent-skills --skill skill-management -a claude-code
Открыть на GitHub

Что делает 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-code

2Вручную: положить файлы

~/.claude/skills/skill-management/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/skill-management/

По шагам, с командами для каждой платформы: Как установить скилл в 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

Похожие скиллы

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →
skill-governance-loop cnfjlhj Скилл skill-governance-loop для управления другими скиллами: проверяет качество, сравнивает версии, решает, оставить, включить или удалить конкретный скилл из локальной коллекции. CX Codex +1 ★ 475звёзд репо skills-governance cnfjlhj Скилл skills-governance сканирует локальные каталоги скиллов, находит дубликаты по имени и помогает решить, что оставить, отключить или архивировать. CX Codex +1 ★ 475звёзд репо memory-md-management giuseppe-trisciuoglio Скилл memory-md-management проверяет файлы памяти проекта вроде CLAUDE.md, ставит им оценку по шести критериям и предлагает точечные правки. CX Codex +1 3 700установок skill-improver bfollington Скилл skill-improver для Claude Code разбирает сбои и затруднения в работе других скиллов. Запускается в конце большой сессии или после повторения одной проблемы. CX Codex +1 102установок skills-eval athola Скилл skills-eval для Claude Code проверяет структуру, расход токенов и интеграцию инструментов в других скиллах. Находит проблемы и составляет план исправлений. CX Codex +1 1установок dependency-management-deps-audit sickn33 Скилл dependency-management-deps-audit проверяет зависимости проекта на известные уязвимости, лицензионные конфликты и устаревшие пакеты, а затем расставляет порядок починки. CX Codex +1 1установок

Из того же набора106

Весь набор →
turborepo Помогает настраивать Turborepo в монорепозиториях на JavaScript и TypeScript. Запускается при настройке задач, кэша, зависимостей между пакетами и CI. CX Codex +1 108установок realtime-sync Скилл realtime-sync помогает проектировать синхронизацию данных с низкой задержкой, связывать WebTransport, CRDT и пакетный рендеринг потоков ИИ-токенов. CX Codex +1 108установок plan-first-development Скилл plan-first-development для Claude Code помогает спланировать проект до начала разработки и вести прогресс между сессиями. Он включается при запуске проекта, крупных изменениях и разбиении работы на этапы. CX Codex +1 107установок tracer-bullets Скилл tracer-bullets для Claude Code разбивает многоуровневую разработку на вертикальные срезы. Каждый срез проверяется до начала следующего. CX Codex +1 107установок expert-instruction Скилл expert-instruction для Claude Code помогает проектировать системные инструкции для ИИ-агентов. Он включается при настройке роли агента, ограничений, формата ответов и работы с инструментами. CX Codex +1 106установок codebase-packager Скилл codebase-packager для Claude Code готовит контекст крупного репозитория для ИИ-кодинга. Он собирает дайджесты, упаковывает файлы и помогает проследить связи между ними. CX Codex +1 105установок meta-agent-creator Скилл meta-agent-creator для Claude Code помогает создавать субагентов и настраивать их параметры. Используйте его при проектировании делегирования задач и ограничении доступа к инструментам. CX Codex +1 104установок localization-engineer Скилл localization-engineer для Claude Code внедряет паттерны интернационализации и локализации в веб-приложения. Помогает настроить ICU, плюрализацию CLDR, RTL-вёрстку и теги hreflang. CX Codex +1 103установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой