Skill - это способ оформить повторяемую процедуру как продукт: каталог с файлом SKILL.md и опциональными вспомогательными файлами. Он появляется как slash-команда и может автоматически подбираться Claude по своему description. Старые команды в .claude/commands/*.md остаются совместимыми, но каталог-skill удобнее - в него кладут не только инструкцию, но и скрипты, примеры и references. Ключевое различие с командой: skill авто-триггерится по релевантности задачи, а команда - это явный вызов человеком.

Skills живут в нескольких местах с понятной семантикой имени. Project-skill - в .claude/skills/<command>/SKILL.md, user-skill - в ~/.claude/skills/, plugin-skill - в skills/ плагина, legacy-команды - в .claude/commands. В project- и user-skill имя команды берётся из имени каталога, а поле name во frontmatter меняет отображаемый ярлык; в plugin-skill команда пространственно именована как /plugin-name:skill-name. Это позволяет держать одноимённые навыки из разных источников без конфликтов.

Хороший skill начинается с честного frontmatter и проверяемого тела. Полезно один раз увидеть цельный пример - навык review-change: с description для автоподбора, disable-model-invocation, argument-hint, объявленными аргументами и узким allowed-tools, а в теле - пронумерованная процедура ревью. Named-аргументы объявляют во frontmatter, и это безопаснее shell-подобных догадок: в теле доступны $ARGUMENTS, индексные $0, именованные $base и служебные переменные вроде ${CLAUDE_SKILL_DIR}.

У аргументов есть тонкость подстановки, которую надо знать. Отсутствующий индексный аргумент остаётся в тексте буквально, а отсутствующий именованный становится пустой строкой - поэтому в теле явно задают fallback-инструкцию на случай пустого значения. Иначе навык, вызванный без аргумента, подставит пустоту и поведёт себя не так, как задумано. Проверяемость навыка начинается ровно здесь: с ясного поведения при отсутствующем и при заданном аргументе.

Frontmatter - это карта решений, и каждое поле оправдывается ролью навыка, а не открывается для полноты. description и when_to_use нужны для автоподбора; disable-model-invocation - когда запускать должен только человек; allowed-tools и disallowed-tools - для точечного контроля инструментов; model и effort - когда качество и стоимость измерены; context: fork - когда шумную работу выносят в отдельный контекст. Полную карту ключевых полей удобно держать перед глазами таблицей.