English Пиши ми

Първият ти skill

Урок 2 от 55 мин четенеобновен 15.11.2026

Една папка, един файл и две полета в началото му. Тук е как една повтаряща се задача става skill и защо описанието е най-важният ред.

В този урок
  1. От какво се състои
  2. Направи папката
  3. Напиши SKILL.md
  4. Описанието решава всичко
  5. Провери дали работи
  6. Когато файлът порасне
  7. Нека Claude го напише
  8. Запомни

От какво се състои

Един skill е папка с файл SKILL.md вътре. Файлът е обикновен Markdown и има две части. Най-горе, между два реда с три тирета, стоят името и описанието. Под тях е самата инструкция.

Направи папката

За първи skill избери работа, която вече си вършил няколко пъти. Аз ще покажа моя за проверка след промяна по кода на сървъра.

Името пиши с латински букви и тирета, без интервали. Папката е в домашната ти директория:

В терминала
mkdir -p ~/.claude/skills/proverka-sled-promyana

Напиши SKILL.md

В тази папка създаваш файл SKILL.md с това съдържание:

SKILL.md
---
name: proverka-sled-promyana
description: Използвай след всяка промяна по сървърния код или когато кажа «рестартирай» или «провери логовете». Рестартира програмата и чете логовете, преди да каже, че е готово.
---

# Проверка след промяна

## Стъпки
1. Рестартирай програмата.
2. Изчакай две секунди.
3. Прочети последните 25 реда от лога.

## Какво търсиш
- Добре: ред, който казва, че сървърът е стартирал.
- Зле: всеки ред с Error.

Ако има грешка, оправи причината и повтори стъпките.
Никога не казвай «готово», преди логът да е чист.

Смени стъпките с твоите и остави формата.

Описанието решава всичко

Докато skill-ът не е зареден, Claude вижда от него само описанието. По него решава дали работата ти е за този skill. Затова в описанието пишеш кога се ползва, а не колко е полезен.

Добро описание съдържа думите, които ти наистина казваш. При мен там пише «рестартирай» и «провери логовете», защото точно така говоря. Естествено, не го прави и дълго, защото в списъка със skills описанието се реже след около 1 500 знака.

Провери дали работи

Промените се хващат в същия разговор, без да рестартираш Claude Code. Пробваш по двата начина.

  • Пишеш /proverka-sled-promyana и гледаш дали следва стъпките.
  • Отваряш нов разговор и казваш задачата с твои думи, без да споменаваш skill-а. Ако не го зареди сам, описанието е слабо.

Ако папката skills не е съществувала, когато си отворил разговора, напиши /reload-skills.

Когато файлът порасне

В документацията препоръчват SKILL.md да е под 500 реда. Всичко по-подробно отива в отделни файлове в същата папка, а в SKILL.md само казваш кога да се прочетат.

Моят skill за видео е устроен точно така. Самият файл е кратка карта кой какво прави, а правилата за разположение, движение и звук са в отделни файлове до него. Claude отваря само този, който му трябва за текущата стъпка.

Правило

Ако един skill прави нещо, което не искаш да тръгва само, например да пусне сайт на живо, добави в началото ред disable-model-invocation: true. Тогава той се зарежда единствено когато ти напишеш името му.

Нека Claude го напише

Аз рядко пиша skill от празен лист. Свършвам работата в разговора, поправям каквото не е наред и накрая казвам:

в Claude Code
Направи skill от това, което току-що направихме.
В описанието напиши кога да се ползва, с думите, които аз използвам.

След това го чета и махам излишното. Чужд skill от интернет чета още по-внимателно, преди да го сложа при мен, защото Claude ще изпълни каквото пише вътре.

В Codex

Файлът е същият и пак се казва SKILL.md, като полетата name и description са задължителни. Папката е .agents/skills вместо .claude/skills.

Запомни

  • Skill е папка със SKILL.md: име и описание горе, стъпки отдолу.
  • В описанието пишеш кога се ползва, с думите, които ти казваш.
  • Пробвай го на ръка с /име и после в нов разговор без името.
  • Дръж файла кратък, а подробностите изнеси в отделни файлове.

Искаш да стане по-бързо?

Вземи шаблоните готови. Наръчникът ти дава CLAUDE.md, brain.md и AGENTS.md за попълване и план за първите 30 дни.19 € Нека го настроя вместо теб. Изграждам ти мозъка, паметта и първите агенти и после ти показвам как да ги караш сам.от 250 €

Ако нещо в урока не е ясно, пиши ми в Instagram на @bravis.ai.

Съдържание

В този урок

  1. От какво се състои
  2. Направи папката
  3. Напиши SKILL.md
  4. Описанието решава всичко
  5. Провери дали работи
  6. Когато файлът порасне
  7. Нека Claude го напише
  8. Запомни

Skills, hooks и проверки

  1. Какво е skill и кога ти трябва
  2. Първият ти skill
  3. Hooks: правила, които не разчитат на паметта
  4. Проверки, които спират грешката навреме
  5. Моите правила: всяка поправка става правило