workflow · makenotion, workers — скилл для Claude Code: что делает и как установить
Скилл для Claude Code добавляет в шаблон Notion Worker новый Workflow: выбирает триггер, делит работу на шаги и создаёт файл в src/workflows/. Для нового сценария с триггером создаётся отдельный Workflow.
MIT ★ 232 обновлён 2026-10-25
npx skills add makenotion/notion-cookbook --skill workflow -a claude-codeЧто делает workflow
Скилл добавляет в шаблон Notion Worker новый Workflow. Сначала он читает AGENTS.md и файлы, которые уже лежат в src/workflows/, а также смотрит объявленные триггеры. Потом выбирает сам триггер, результат и границы шагов. Файл создаётся один, с именем в camelCase, прямо в src/workflows/.
Внутри — экспорт createWorkflow(...) по умолчанию и типизированные конструкторы триггеров. Любой недетерминированный код идёт в context.step(...) с await, поэтому шаги переживают повторный прогон. У каждого шага постоянное отображаемое имя; для повторяющихся шагов имя остаётся тем же, а рядом встаёт стабильный составной key, например { key: ["process-page", page.id] }. Шаг возвращает только JSON-совместимые значения, а его id работает ключом идемпотентности там, где это поддерживается.
Креденшелы скилл не пишет. Если для конфигурации нужны переменные, в .env.example попадут только их имена и безопасные заглушки — сами значения в шаблон не идут. В конце скилл прогоняет npm run check и npm run build.
Какие задачи решает
- завести Workflow в шаблоне Notion Worker с нуля
- разложить недетерминированную работу по
context.step(...), чтобы шаги пережили повтор - выбрать триггер и границы шагов до первой строки кода
- сделать повторяющиеся шаги идемпотентными через составной
key - заполнить
.env.exampleбез паролей и токенов
Примеры запросов агенту
- /workflow Добавь в шаблон новый Workflow: триггер по новой странице, дальше шаг с запросом к API.
- Разложи генерацию отчёта по
context.step(...)и дай каждому шагу постоянное имя. - Прогони
npm run checkиnpm run buildдля нового workflow.
Как установить workflow
1Через Skills CLI (Vercel)
npx skills add makenotion/notion-cookbook --skill workflow -a claude-code2Вручную: положить файлы
~/.claude/skills/workflow/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/workflow/
1Через Skills CLI (Vercel)
npx skills add makenotion/notion-cookbook --skill workflow -a codex2Вручную: положить файлы
.agents/skills/workflow/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add makenotion/notion-cookbook --skill workflow -a cursor2Вручную: положить файлы
.cursor/skills/workflow/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install makenotion/notion-cookbook workers/agents/skills/workflow2Вручную: положить файлы
.github/skills/workflow/SKILL.md1Через Skills CLI (Vercel)
npx skills add makenotion/notion-cookbook --skill workflow -a gemini-cli2Командой платформы
gemini skills install https://github.com/makenotion/notion-cookbook --path workers/agents/skills/workflowВручную: положить файлы
.devin/skills/workflow/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add makenotion/notion-cookbook --skill workflow -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о workflow
Как установить workflow в Claude Code?
Выполните npx skills add makenotion/notion-cookbook --skill workflow -a claude-code. Скилл встанет в ~/.claude/skills/workflow/SKILL.md.
Что делает скилл workflow?
Добавляет в шаблон Notion Worker новый Workflow: читает AGENTS.md, выбирает триггер и границы шагов, пишет один файл в src/workflows/ и проверяет сборку.
Зачем повторяющимся шагам общий key?
Имя шага остаётся постоянным, поэтому два одинаковых шага различают по составному key, например { key: ["process-page", page.id] }. Там, где это поддерживается, ключом идемпотентности служит id шага.
Исходный текст
SKILL.md · MIT
---
name: workflow
description: Scaffold a Notion Worker Workflow with typed triggers and replay-safe durable steps.
user-invocable: true
disable-model-invocation: true
---
# Workflow
Use this skill to add a Workflow to this template.
1. Read `AGENTS.md` and the existing files in `src/workflows/`.
2. Inspect the installed Workflow and trigger declarations.
3. Choose the trigger, outcome, step boundaries, and required configuration.
4. Create one camelCase file directly in `src/workflows/`.
5. Default-export `createWorkflow(...)` and use typed trigger creators.
6. Put all non-deterministic work in awaited `context.step(...)` calls.
7. Give each step a stable display name. For repeated steps, keep the name
constant and pass a stable, unique composite `key`, such as
`{ key: ["process-page", page.id] }`.
8. Return JSON-safe values needed by later steps.
9. Use the step `id` as an idempotency key when supported.
10. Run `npm run check` and `npm run build`.
Do not write credentials. Add only environment variable names and safe
placeholders to `.env.example` when configuration is required.
© makenotion · MIT · makenotion/notion-cookbook
Похожие скиллы
Все скиллы по теме «Настройка агента: память, контекст, субагенты» →Сначала — workflow от других авторов.