Как работают скилы в Claude Code

mkdir -p .claude/skills/commit-message

---
name: commit-message
description: Пишет сообщение коммита к подготовленным изменениям в стиле этого репозитория. Используй, когда пользователь просит закоммитить правки или придумать сообщение коммита.
---

## Подготовленные изменения

!`git diff --staged`

## Все изменения в рабочей копии

!`git status --short`

## Последние коммиты

!`git log --oneline -15`

## Что сделать

Напиши сообщение коммита к подготовленным изменениям. Если их нет, покажи изменённые файлы и спроси, какие добавить в коммит.

Первая строка: тип и суть правки, не длиннее 72 символов, без точки в конце. Типы: feat, fix, refactor, test, docs, chore. Язык и стиль бери из последних коммитов.

После пустой строки в двух-трёх предложениях объясни, зачем нужна правка. Не пересказывай diff построчно.

Покажи сообщение. Если пользователь просил закоммитить, выполни git commit с этим сообщением.

---
name: api-conventions
description: Правила REST API этого проекта. Используй, когда пишешь или меняешь эндпоинты.
user-invocable: false
paths:
  - "src/api/**/*.ts"
---

Пути пиши в kebab-case, поля JSON в camelCase.
Ошибки возвращай в формате { "error": { "code": "...", "message": "..." } }.
Списки всегда отдавай с пагинацией.

.claude/skills/release/
├── SKILL.md
├── checklist.md
└── scripts/
    └── preflight.sh

---
name: release
description: Выпускает новую версию проекта по чек-листу команды
disable-model-invocation: true
argument-hint: "[версия]"
arguments: [version]
allowed-tools: Bash(${CLAUDE_SKILL_DIR}/scripts/preflight.sh *)
---

Выпусти версию $version. Если версия не указана, спроси её и остановись.

## Состояние репозитория

!`git status --short`

!`git log --oneline -20`

## Шаги

1. Запусти `${CLAUDE_SKILL_DIR}/scripts/preflight.sh $version`. Если скрипт нашёл проблемы, покажи их и остановись.
2. Пройди по чек-листу из [checklist.md](checklist.md) и про каждый пункт напиши, выполнен ли он.
3. Обнови версию в package.json и добавь в CHANGELOG.md раздел $version по коммитам с прошлого релиза.
4. Закоммить изменения с сообщением «release: v$version» и поставь тег v$version.
5. Покажи итог и дождись подтверждения. Только после него выполни git push вместе с тегом.

#!/usr/bin/env bash
# Проверки перед релизом: печатает проблемы и выходит с кодом 1
version="$1"
failed=0

if [ -z "$version" ]; then
  echo "Не указана версия"
  exit 1
fi
if [ "$(git branch --show-current)" != "main" ]; then
  echo "Релиз выпускают из ветки main"
  failed=1
fi
if [ -n "$(git status --porcelain)" ]; then
  echo "В рабочей копии есть незакоммиченные изменения"
  failed=1
fi
if git rev-parse -q --verify "refs/tags/v$version" >/dev/null; then
  echo "Тег v$version уже существует"
  failed=1
fi
exit $failed

{
  "name": "team-tools",
  "description": "Скилы нашей команды для коммитов и релизов",
  "version": "1.0.0",
  "author": {
    "name": "Acme"
  }
}

{
  "name": "acme-tools",
  "description": "Плагины нашей команды",
  "owner": {
    "name": "Acme"
  },
  "plugins": [
    {
      "name": "team-tools",
      "source": "./plugins/team-tools",
      "description": "Скилы для коммитов и релизов"
    }
  ]
}

claude plugin marketplace add acme/claude-plugins
claude plugin install team-tools@acme-tools