skill
workflow
Scaffold a Notion Worker Workflow with typed triggers and replay-safe durable steps.
Set up
Skills are installed by placing their folder where your agent loads skills.
The download comes from github.com/makenotion/notion-cookbook itself, not from our server, so what you get is exactly what its author published. The ZIP holds the whole collection; take the folder workers/agents/skills/workflow out of it for workflow.
Part of the collection makenotion/notion-cookbook.
npx skills add makenotion/notion-cookbook --skill workflow
Or by hand: Copy the folder workers/agents/skills/workflow from github.com/makenotion/notion-cookbook into ~/.claude/skills/workflow/ (Claude Code) or your agent's skills folder. Check the collection's own README for other agents.
README
synced Oct 14, 2026Workflow
Use this skill to add a Workflow to this template.
- Read
AGENTS.mdand the existing files insrc/workflows/. - Inspect the installed Workflow and trigger declarations.
- Choose the trigger, outcome, step boundaries, and required configuration.
- Create one camelCase file directly in
src/workflows/. - Default-export
createWorkflow(...)and use typed trigger creators. - Put all non-deterministic work in awaited
context.step(...)calls. - 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] }. - Return JSON-safe values needed by later steps.
- Use the step
idas an idempotency key when supported. - Run
npm run checkandnpm run build.
Do not write credentials. Add only environment variable names and safe
placeholders to .env.example when configuration is required.