Почему это важно именно вам
Еженедельный отчёт — одна из тех задач, которые каждую пятницу начинаются с чистого листа. Вы садитесь, открываете браузер, копируете прошлую версию, удаляете данные, вставляете новые, думаете, что написать в резюме. Это не творческая работа — это рутинный сборочный процесс. Но занимает он 30-45 минут, потому что каждый раз начинается заново.
У директора по развитию структура отчёта принципиально одна и та же: что сделали за неделю, что не сделали и почему, цифры по ключевым метрикам, планы на следующую неделю, что нужно от руководства. Меняются только данные. Формулировки, логика, структура — стабильны. Это именно тот случай, когда один раз потраченный час на создание skill экономит полчаса каждую неделю — то есть около 26 часов в год.
Skills в Claude Code — это именно про такие повторяемые задачи. Вы один раз описываете, что должен делать Claude, задаёте шаблон, сохраняете в файл — и дальше вызываете одной командой /еженедельный-отчёт. Claude берёт шаблон, задаёт вам несколько уточняющих вопросов (или работает молча, если вы описали достаточно), и выдаёт готовый документ. Никакого «объясни контекст» каждый раз — контекст уже зашит в skill.
Что это такое
Представьте должностную инструкцию для ассистента. Вы один раз пишете: «Когда я прошу подготовить еженедельный отчёт, задай мне четыре вопроса, собери ответы и оформи по вот этому шаблону». Ассистент прочитал, запомнил — теперь достаточно сказать «готовь отчёт», и он знает, что делать.
Skill в Claude Code — это именно такой файл-инструкция. Он живёт в папке .claude/skills/ и содержит два элемента: frontmatter с метаданными (имя, описание) и само тело — инструкцию для Claude на естественном языке. Тело может быть любым: список вопросов, шаблон с плейсхолдерами, правила форматирования, условия ветвления.
Когда вы вводите /еженедельный-отчёт в Claude Code, он находит файл .claude/skills/еженедельный-отчёт/SKILL.md, читает инструкцию и выполняет её. Больше ничего объяснять не нужно — контекст уже в файле.
Skill — это не скрипт, а инструкция на человеческом языке
Вам не нужно писать код. Вы описываете словами, что хотите получить, как это должно выглядеть, какие вопросы задать пользователю. Claude умеет следовать таким инструкциям точно и воспроизводимо.
Чем skill отличается от агента (.claude/agents/)? Агент — автономный специалист с собственными инструментами и правами, которого Claude запускает сам, когда решает, что задача ему по профилю. Skill — инструмент, который вы вызываете вручную командой /имя. Агент — делегат. Skill — ваш личный ритуал, упакованный в команду.
Как работает на практике
Шаг 1. Создайте папку
Если её ещё нет, создайте:
mkdir -p ~/.claude/skills
Папка .claude/skills/ на уровне домашней директории — глобальная: skills из неё будут доступны в любом проекте. Если хотите skill только для конкретного проекта, создайте .claude/skills/ внутри папки проекта.
Шаг 2. Создайте файл skill
Создайте файл .claude/skills/еженедельный-отчёт/SKILL.md. Вот пример полного содержимого:
---
name: еженедельный-отчёт
description: Генерирует еженедельный отчёт директора по развитию по стандартному шаблону
---
Ты помогаешь подготовить еженедельный отчёт директора по развитию.
Сначала задай следующие вопросы по одному (жди ответа на каждый перед следующим):
1. Какой период охватывает отчёт? (например: 26 мая — 1 июня)
2. Перечисли 3–5 главных задач, которые были выполнены на этой неделе. Для каждой — одна строка.
3. Что планировалось, но не было сделано? Кратко — причина.
4. Ключевые цифры недели (трафик, звонки, лиды, конверсии — что актуально). Если нет — напиши «без цифр».
5. Главные задачи на следующую неделю (3–5 пунктов).
6. Что нужно от руководства или смежных команд? Если ничего — «нет блокеров».
После получения всех ответов сформируй отчёт строго по шаблону ниже. Не добавляй ничего от себя, не расширяй ответы пользователя — только структурируй и оформи.
---
## Еженедельный отчёт: [период]
**Дата составления:** [сегодняшняя дата]
### Выполнено
[Список задач из ответа на вопрос 2, каждая с новой строки, через дефис]
### Не выполнено / перенесено
[Ответ на вопрос 3. Если нечего — написать «Все плановые задачи выполнены»]
### Ключевые метрики
[Ответ на вопрос 4. Если «без цифр» — написать «Метрики в этот период не отслеживались»]
### Планы на следующую неделю
[Список задач из ответа на вопрос 5]
### Требуется от руководства
[Ответ на вопрос 6]
---
*Отчёт сформирован автоматически*
Разберём структуру по частям.
Frontmatter (между ---) — метаданные skill. Команда берётся из имени папки скилла, а не из поля name: папка еженедельный-отчёт/ даёт команду /еженедельный-отчёт. Поле name во frontmatter — только подпись в списке /skills. Назвали папку еженедельный-отчёт/ — вызываете командой /еженедельный-отчёт. Поле description помогает Claude понять контекст skill: если вы позже создадите несколько похожих skill, точное описание снижает вероятность путаницы.
Инструкция перед шаблоном — это вы разговариваете с Claude. Здесь вы говорите: задай вопросы по одному, жди ответа, и только потом формируй отчёт. Это важно — без «жди ответа» Claude может задать все вопросы сразу и ждать одного большого блока текста, что значительно неудобнее диалога.
Шаблон — раздел после «После получения всех ответов». Вы описываете структуру будущего документа с плейсхолдерами в квадратных скобках. Claude подставит реальные данные из ваших ответов на вопросы. Чем точнее описаны плейсхолдеры, тем предсказуемее результат.
Важный нюанс: Claude читает весь файл skill целиком перед тем, как начать диалог. Это значит, что порядок в файле имеет значение: сначала инструкция о поведении, потом шаблон. Если поместить шаблон первым, Claude может начать генерировать отчёт сразу, не задав ни одного вопроса.
Шаг 2а. Адаптируйте вопросы под себя
Шаблон выше универсальный, но директор по развитию рекламного агентства и директор по развитию строительной компании будут спрашивать разное. Прямо сейчас, до первого запуска, стоит пройтись по списку вопросов и убрать лишнее.
Если у вас нет еженедельных цифровых метрик — уберите вопрос четыре или перефразируйте его под реальность: «Что из аналитики было важным на этой неделе?» Если отчёт идёт только генеральному и не требует раздела «требуется от руководства» — уберите вопрос шесть. Skill должен отражать вашу реальную рабочую жизнь, а не универсальную схему из учебника.
Не бойтесь переделывать шаблон. Это markdown-файл из 40 строк — правится за три минуты.
Шаг 3. Проверьте, что файл виден
claude /еженедельный-отчёт
Если skill не найден, Claude скажет об этом прямо. Скорее всего, проблема в имени папки — команда берётся из него: папка еженедельный-отчёт/ даёт /еженедельный-отчёт.
Команду задаёт имя папки, а не поле name
Папка .claude/skills/еженедельный-отчёт/ даёт команду /еженедельный-отчёт — независимо от того, что написано в поле name. Оно влияет только на подпись в списке /skills. Хотите вызывать скилл по-русски — так и назовите папку.
Шаг 4. Запустите и ответьте на вопросы
Claude начнёт диалог:
Какой период охватывает отчёт?
Вы отвечаете. Claude задаёт следующий вопрос. После шести ответов — получаете готовый документ в нужном формате.
Как выглядит результат
## Еженедельный отчёт: 26 мая — 1 июня
**Дата составления:** 1 июня 2026
### Выполнено
- Согласован бюджет по кампании Самолёт на июнь
- Запущен новый поток лидов через Авито-таргет в трёх регионах
- Проведена встреча с командой коллцентра, скорректированы скрипты
- Сдан ежемесячный отчёт по метрикам порталов
### Не выполнено / перенесено
- Подключение СПб-ЖК к М60 — перенесено на следующую неделю, ждём данные от парсера
### Ключевые метрики
- Звонки: 1 840 (план 1 700, +8%)
- Лиды через квиз: 214
- Конверсия звонок→лид: 11,6%
### Планы на следующую неделю
- Завершить подключение СПб-ЖК к М60
- Запустить тест нового шаблона писем для застройщиков
- Провести разбор записей с коллцентром
### Требуется от руководства
- Подтверждение бюджета на июнь по каналу Циан
---
*Отчёт сформирован автоматически*
Весь процесс от запуска до готового документа — 4-5 минут.
Шаг 5. Сохраните результат
После того как Claude выдал отчёт, сохраните его в файл. Самый простой способ — попросить Claude прямо в том же диалоге:
Сохрани этот отчёт в файл ~/Documents/отчёты/2026-06-01.md
Или настройте skill так, чтобы он сохранял автоматически. Для этого добавьте в конец инструкции:
После формирования отчёта сохрани его в файл
~/Documents/отчёты/[год]-[месяц]-[последний день периода].md
и сообщи путь к файлу.
Автосохранение удобно, если вы хотите накапливать архив отчётов и впоследствии анализировать их (например, агентом-аналитиком из Дня 25).
Папку для отчётов лучше создать заранее
Claude создаст файл, но не создаст папку, если её не существует. Один раз mkdir -p ~/Documents/отчёты — и больше к этому не возвращаетесь.
Частые ошибки
Задаёт все вопросы сразу. Это случается, если в инструкции не написано явно «жди ответа на каждый перед следующим». Claude по умолчанию старается быть эффективным и выдаёт всё за раз. Добавьте фразу — проблема уйдёт.
Отчёт расширяет ваши ответы. Написали «встреча с коллцентром», получили абзац с предположениями о том, что обсуждалось. Причина: нет явного указания «не добавляй ничего от себя». Добавьте в инструкцию строку «структурируй только то, что ответил пользователь, не интерпретируй и не дополняй» — и отчёт станет точным зеркалом ваших ответов.
Без явного запрета Claude будет улучшать
Это его природа — делать текст полнее и лучше. В контексте отчёта это скорее вред: вы получаете слова, которых не говорили. Явный запрет в инструкции решает это раз и навсегда.
Skill не находится по команде. Проверьте три вещи: папка скилла лежит в .claude/skills/ (глобальной или проектной), внутри неё есть SKILL.md, имя папки без пробелов и точно совпадает с тем, что вы набираете после слеша.
Шаблон слишком жёсткий, а данные не влезают. Если у вас было 8 выполненных задач, а шаблон предполагает «3-5» — возникает конфликт. Решение: не указывайте жёсткое количество в шаблоне, только структуру. Пусть Claude сам форматирует список нужной длины.
Skill — живой документ
После первых нескольких использований вы наверняка захотите что-то поправить. Это нормально: открыли файл, изменили инструкцию, сохранили. Следующий запуск уже работает по новым правилам.
Когда нужно / когда нет
Создавайте skill, когда:
- Задача повторяется минимум раз в неделю
- Структура результата стабильна — меняются только данные
- Каждый раз приходится объяснять контекст или копировать шаблон из прошлой версии
- Есть конкретный набор вопросов, ответы на которые определяют результат
Помимо еженедельного отчёта, хорошие кандидаты для skills: /встреча (протокол по итогам встречи), /тз (техническое задание по стандартному формату компании), /бриф (бриф для подрядчика), /питч (структура презентации под конкретный тип аудитории).
Не нужен skill, когда:
- Задача разовая или почти разовая — не стоит тратить время на упаковку
- Каждый раз нужен принципиально другой подход — skill будет только мешать гибкости
- Задача уже закрыта агентом (
.claude/agents/), который работает автономно — дублировать не нужно - Результат сильно зависит от уникального контекста, который сложно описать заранее
Граница между skill и агентом: skill — это команда, которую вы запускаете сами и в которой вы участвуете (отвечаете на вопросы). Агент — это специалист, которому Claude делегирует задачу без вашего участия в процессе. Иногда границы размываются: skill может вызывать агента для части работы — например, после сбора данных передать их агенту-аналитику для интерпретации. Но начинать лучше с простого: один skill, один шаблон, один результат.
Хороший skill — это ваши лучшие 20 минут, упакованные в 5
Если вы знаете, как написать идеальный еженедельный отчёт, но каждый раз тратите на это полчаса — skill сохраняет структуру и дисциплину, убирает рутину.
Связь с другими уроками
День 22 — первый агент. Понимание разницы принципиально: агент в .claude/agents/ запускается автоматически по задаче, skill в .claude/skills/ — только по вашей команде. Это разные инструменты для разных ситуаций.
День 11 — CLAUDE.md. Если в вашем CLAUDE.md прописан контекст (компания, проекты, роли), Claude использует его при выполнении skill. То есть skill «знает», что вы директор по развитию Новострой-М, и не нужно каждый раз объяснять это заново.
День 31 — введение в Фазу 4 (skills/). В этом уроке — обзор концепции и структуры папки. День 32 — первая практика. В днях 33–34 вы научитесь передавать skills аргументы и соберёте библиотеку, что позволит, например, писать /встреча Самолёт вместо того, чтобы отвечать на вопрос «с кем встреча».
Задание на сегодня
Создайте файл ~/.claude/skills/еженедельный-отчёт/SKILL.md с frontmatter и инструкцией по шаблону из урока. Запустите /еженедельный-отчёт и пройдите все шесть вопросов до получения готового документа — можно с тестовыми данными за прошлую неделю.
Критерий «выполнено»: у вас есть файл отчёта в формате markdown, который вы могли бы отправить руководству прямо сейчас.
Резюме
- Skill — файл в
.claude/skills/имя/SKILL.mdс frontmatter и инструкцией на естественном языке; вызывается командой/имя - Подходит для повторяемых задач с фиксированной структурой: еженедельный отчёт, протокол встречи, бриф подрядчику
- В инструкции явно указывайте: задавать вопросы по одному, ждать ответа, не дополнять данные пользователя
- Skill не заменяет агента: агент работает автономно, skill — это ритуал под вашим управлением
- После первых использований skill дорабатывается: открыли файл, изменили инструкцию, следующий запуск уже лучше