### **Что такое skill?** Skill — это обычная папка, внутри которой лежат: - `SKILL.md` (обязательный): главный файл с инструкциями в формате Markdown + YAML frontmatter. - `scripts/` (опционально): скрипты на Python, Bash и т.д. - `references/` (опционально): справочные материалы, которые Claude подгрузит при необходимости. - `assets/` (опционально): шаблоны, шрифты, иконки и другие ресурсы. ### **Принципы, на которых всё построено:** #### **Progressive Disclosure:** Skills устроены как матрёшка из трёх уровней: - **Первый уровень, YAML frontmatter:** всегда на виду у Claude в системном промпте. Это «визитная карточка» skill: достаточно информации, чтобы понять, когда его подключать, но без лишней нагрузки на контекст. - **Второй уровень, тело SKILL.md:** подгружается, когда Claude решает, что skill подходит к текущей задаче. Здесь лежат полные инструкции. - **Третий уровень, вложенные файлы:** дополнительные материалы из папки skill, которые Claude подтянет сам, если понадобятся. За счёт этого расход токенов минимален, а экспертиза всегда под рукой. #### **Совместимость (Composability):** Claude может загрузить сразу несколько skills. Поэтому ваш skill не должен вести себя так, будто он единственный. Пишите его с расчётом на совместную работу с другими. #### **Портативность (Portability):** Один и тот же skill работает в Claude.ai, Claude Code и через API без каких-либо правок. Единственное условие: среда должна поддерживать зависимости, которые нужны вашему skill. ### **Skills + MCP-коннекторы**: #### **Аналогия с кухней:** **MCP** — это профессиональная кухня: плита, ножи, продукты, всё оборудование. **Skills** — это рецепты: пошаговые инструкции, как из всего этого приготовить что-то стоящее. По отдельности полезно, но вместе получается совсем другой уровень. | MCP | Skills | | --------------------------------------------------------------- | ------------------------------------------------------- | | Связывает Claude с вашим сервисом (Notion, Asana, Linear и др.) | Объясняет Claude, как грамотно работать с этим сервисом | | Даёт доступ к данным и инструментам в реальном времени | Закрепляет рабочие процессы и лучшие практики | | Определяет, что Claude **может** делать | Определяет, как Claude **должен** это делать | #### **Без skills:** - Пользователь подключил MCP и завис: непонятно, с чего начать - В поддержку летят вопросы: «а как мне сделать X через вашу интеграцию?» - Каждый новый разговор начинается с чистого листа - Результаты пляшут, каждый формулирует запросы по-своему #### **Со skills:** - Готовые сценарии подключаются автоматически, когда нужно - Инструменты используются стабильно и предсказуемо - Лучшие практики зашиты в каждое взаимодействие - Порог входа для новых пользователей резко снижается