К основному содержанию
скилл CX Codex

workflow · makenotion, workers — скилл для Claude Code: что делает и как установить

Скилл для Claude Code добавляет в шаблон Notion Worker новый Workflow: выбирает триггер, делит работу на шаги и создаёт файл в src/workflows/. Для нового сценария с триггером создаётся отдельный Workflow.

MIT ★ 232 обновлён 2026-10-25

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add makenotion/notion-cookbook --skill workflow -a claude-code
Открыть на GitHub

Что делает 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-code

2Вручную: положить файлы

~/.claude/skills/workflow/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/workflow/

По шагам, с командами для каждой платформы: Как установить скилл в 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 от других авторов.

workflow Vercel Inc. Создаёт надёжные перезапускаемые цепочки задач через Vercel Workflow SDK, когда операциям нужно переживать перезапуски сервиса и ждать внешние события. CX Codex +1 5 500установок workflow makenotion Помогает создавать и проверять workflow для Notion App с типизированными триггерами и безопасными при повторном запуске шагами. Перед правками он требует прочитать инструкцию SDK. CX Codex +1 ★ 232звёзд репо notion-automation claude-office-skills Скилл notion-automation для Claude Code автоматизирует базы Notion и переносит события между сервисами. Шаблоны n8n охватывают ведение лидов и проектных задач. CX Codex +1 5 000установок notion-api intellectronica Скилл для взаимодействия с Notion API через REST-запросы. Даёт агенту полный доступ к страницам, базам данных, блокам и комментариям — читать, создавать, обновлять и удалять контент. CX Codex +1 106 200установок notion acedatacloud Скилл подключает Claude Code к Notion через REST API: он ищет, читает и изменяет страницы, а также работает с базами данных. CX Codex +1 215установок connect-apps Composio Плагин connect-apps для Claude Code, который подключает к 500+ приложениям: Gmail, Slack, GitHub, Notion и другим. Выполняет действия прямо из кода — отправляет письма, создаёт задачи, постит сообщения. ★ 2 003звёзд репо notion-sdk terrylica Скилл notion-sdk для Claude Code и Codex, работает с Notion через официальный Python SDK. Создаёт страницы и базы данных, запрашивает информацию, добавляет блоки контента — всё программно, без ручного ввода. CX Codex +1 133установок notion-webhooks hookdeck Скилл notion-webhooks помогает принимать и верифицировать вебхуки Notion, проходить первый рукопожатие-хэндшейк и разбирать события рабочего пространства. CX Codex +1 121установок

Из того же набора17

Весь набор →
workflow-validate Скилл workflow-validate разбирает файлы в src/workflows/ и находит ошибки типизации триггеров и небезопасные повторы шагов. Пригодится перед выкаткой воркфлоу в прод. CX Codex +1 ★ 232звёзд репо workflow-guide Скилл workflow-guide для Claude Code задаёт правила написания надёжных воркфлоу в Notion Cookbook: изолированные шаги, защита от повторов и безопасный реплей данных. CX Codex +1 ★ 232звёзд репо sync Скилл sync помогает спроектировать и добавить синхронизацию данных в Notion Worker. Подходит, когда нужно выбрать режим, схему и пагинацию. CX Codex +1 ★ 232звёзд репо sync-validate Скилл sync-validate для Claude Code проверяет код синхронизации на ошибки курсора, пагинации, состояния и удаления данных. Запускается по запросу на ревью sync-capability. CX Codex +1 ★ 232звёзд репо sync-guide Скилл sync-guide учит ассистента проектировать интеграции с Notion Workers: настраивать пакетную загрузку, разделять backfill и delta-потоки и удалять устаревшие записи. CX Codex +1 ★ 232звёзд репо sync-debug Скилл sync-debug для Claude Code и других ИИ-агентов разбирает падающие или некорректные синхронизации в Notion: снимает логи запусков, находит ошибку и сверяет её с кодом. CX Codex +1 ★ 232звёзд репо custom-blocks Скилл custom-blocks помогает собрать интерактивный интерфейс внутри Notion, который читает и меняет данные рабочего пространства. CX Codex +1 ★ 232звёзд репо auth-guide Скилл auth-guide настраивает авторизацию во внешних сервисах для Notion Workers: токены, проксированные учётные данные и OAuth. Пригодится при интеграции воркера со сторонними API вроде GitHub или Stripe. CX Codex +1 ★ 232звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой