[[Claude Skills — Гайд|← К оглавлению]] · [[Claude Skills - 00. Введение|← Введение]] --- # Основы — структура и принципы ## Из чего состоит skill Skill — это папка. Внутри: - `SKILL.md` — **обязательный**, главный файл с инструкциями - `scripts/` — опционально, скрипты на Python, Bash и т.д. - `references/` — опционально, справочные материалы - `assets/` — опционально, шаблоны, шрифты, иконки ## Три принципа, на которых всё построено ### Progressive Disclosure Skills устроены как матрёшка из трёх уровней: **Уровень 1 — YAML frontmatter:** всегда на виду у Claude в системном промпте. Это "визитная карточка" skill: достаточно, чтобы понять, когда его подключать, без лишней нагрузки на контекст. **Уровень 2 — тело SKILL.md:** подгружается, когда Claude решает, что skill подходит к задаче. Здесь полные инструкции. **Уровень 3 — вложенные файлы:** дополнительные материалы из папки skill, которые Claude подтянет сам при необходимости. За счёт этого расход токенов минимален, а экспертиза всегда под рукой. ### Совместимость (Composability) Claude может загрузить сразу несколько skills. Твой skill не должен вести себя так, будто он единственный — пиши его с расчётом на совместную работу с другими. ### Портативность (Portability) Один и тот же skill работает в Claude.ai, Claude Code и через API без каких-либо правок. ## Правила именования **Папка:** только kebab-case, строчные через дефис. ✅ `notion-project-setup` ❌ `Notion Project Setup`, `notion_project_setup`, `NotionProjectSetup` **Файл:** ровно `SKILL.md` — регистр важен. Ни `SKILL.MD`, ни `skill.md` не пройдут. **README.md** внутри skill не нужен. Вся документация лежит в `SKILL.md` или `references/`. ## Минимальный рабочий SKILL.md ```yaml --- name: your-skill-name description: Что делает. Подключать, когда пользователь просит [конкретные фразы]. --- # Название Skill ## Инструкции ... ``` Этого достаточно для старта. --- Дальше: [[Claude Skills - 02. Планирование и дизайн|🎯 02. Планирование и дизайн →]] [[Claude Skills — Гайд|← К оглавлению]]