Скилове

Какво са skills в Claude Code, как се извикват, къде живеят и как се пише прост SKILL.md.

Skill е пакет от инструкции, който учи Claude как да свърши определен вид задача — стъпките за deploy, checklist за code review, конвенциите на конкретен модул. Вместо да обясняваш едно и също всеки път, го записваш веднъж като skill.

Ключовото е, че skill-овете се зареждат при нужда. В контекста стои само кратко описание; пълните инструкции влизат едва когато задачата ги изисква. Затова можеш да имаш много скилове, без да натовариш сесията.

Как се извикват

Затова description е най-важното поле: то е единственото, което Claude вижда, преди да реши дали да отвори скила.

/create-commit
/deploy-staging

Скиловете от plugin се извикват с префикс — името на плъгина, двоеточие, името на скила:

/mattpocock-skills:tdd

Къде живеят

Прост SKILL.md

Минималният скил е YAML frontmatter с name и description, следван от Markdown инструкции:

---
name: deploy-staging
description: Deploy-ва текущия branch към staging. Use when the user asks to deploy, ship, or push to staging.
---

# Deploy към staging

## Преди deploy

1. Провери, че тестовете минават: `pnpm test`
2. Провери, че няма uncommitted промени: `git status`

## Deploy

```bash
pnpm build
pnpm exec vercel deploy --prebuilt
```

## След deploy

Провери health endpoint-а и докладвай URL-а на deployment-а.

Какво прави описанието добро

Скилът може да е просто промпт

Не всеки скил обвива скриптове и справочни файлове. Ако има абзац, който постоянно преписваш — позиция за ревю, правило за форматиране, молба, с която започваш всеки проект — този абзац вече е скил. Запиши го веднъж и той става една команда.

Най-ясният пример е grilling — интервю скилът на Matt Pocock. Цялото му тяло:

Interview me relentlessly about every aspect of this until we reach a shared
understanding. Walk down each branch of the decision tree, resolving dependencies
between decisions one-by-one. For each question, provide your recommended answer.

Ask the questions one at a time, waiting for feedback on each question before
continuing. Asking multiple questions at once is bewildering.

If a *fact* can be found by exploring the environment (filesystem, tools, etc.),
look it up rather than asking me. The *decisions*, though, are mine — put each one
to me and wait for my answer.

Do not act on it until I confirm we have reached a shared understanding.

Защо заслужава постоянно място: брейнсторм наведнъж винаги има дупки, които не виждаш, защото не знаеш кои части от собствения ти контекст липсват. Интервюто ги намира — въпрос по въпрос, всеки с препоръчан отговор, така че редактираш, вместо да съчиняваш. Това е пакетираната форма на навика „карай го да пита, докато е сигурен“.

Идва в официалния plugin marketplace: пусни /plugin, инсталирай mattpocock-skills и кажи „grill me about this plan“ — или го извикай директно с префикса на плъгина.

Допълнителни файлове

Скилът не е само един файл. До SKILL.md можеш да сложиш:

• references/ — дълги справочни материали, които Claude чете само когато му потрябват.
• scripts/ — готови скриптове, които скилът извиква, вместо да ги пише наново всеки път.
• assets/ — шаблони, конфигурации, patch файлове.

Идеята е SKILL.md да остане кратък и да сочи към останалото: „за пълния списък провери references/checklist.md“.

Skill или субагент?

Двете се комбинират: субагент, който зарежда скил, е много честа схема.