# Workflow Validate

> Review Notion Worker Workflows for trigger typing and retry safety.

- Skill: `makenotion/workflow-validate` (Agent Skill)
- Install (CLI): `npx skillmds@latest add makenotion/workflow-validate`
- Raw SKILL.md: https://api.skillmd.com/api/skills/makenotion/workflow-validate/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Productivity
- Author: makenotion (https://skillmd.com/u/makenotion)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/makenotion/workflow-validate

---


# Workflow validation

Review every file in `src/workflows/` and any modules it calls. Report each
finding with its file, line, impact, and fix.

Treat these as errors:

1. A Workflow is not a direct file or does not default-export `createWorkflow`.
2. Trigger-specific event fields are used without type narrowing.
3. Non-deterministic work occurs outside an awaited step.
4. Step order or names can change between retries.
5. A step result is not JSON-serializable or later code needs an in-memory mutation.
6. A retry-sensitive write lacks an idempotency key or duplicate guard.
7. External failures are ignored, or credentials are hard-coded or logged.

Run `npm run check` and `npm run build` when dependencies are installed.