workflow-best-practices — Claude Code skill: workflows
The workflow-best-practices Claude Code skill covers durable workflows with steps, streaming, and agent runs. It applies when creating, starting, resuming, or saving a workflow.
The skill explains how to arrange workflow orchestration and its steps, stream agent output, and persist results. It uses start and getRun from workflow/api to launch a run or reconnect to one, while agent message parts are saved in a separate step.
The workflow runtime cannot import Node.js modules, so logger calls belong inside a step. Complete Workflow Development Kit Setup first.
What it helps with
separate workflow orchestration from its steps
resume an active or completed run
stream an agent response to the client
save agent output as a workflow step
Example prompts for the agent
Create a chat workflow with separate history and logger steps.
Show how to resume a run with getRun.
Save the agent response parts in a separate step.
How to install workflow-best-practices
1Skills CLI (Vercel)
npx skills add andrelandgraf/fullstackrecipes --skill workflow-best-practices -a claude-code
2Manually: put the files in place
~/.claude/skills/workflow-best-practices/SKILL.md
Copy the whole skill folder; for one project use .claude/skills/workflow-best-practices/
1Skills CLI (Vercel)
npx skills add andrelandgraf/fullstackrecipes --skill workflow-best-practices -a codex
2Manually: put the files in place
.agents/skills/workflow-best-practices/SKILL.md
For all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add andrelandgraf/fullstackrecipes --skill workflow-best-practices -a cursor
2Manually: put the files in place
.cursor/skills/workflow-best-practices/SKILL.md
Cursor also reads .agents/skills/ and .claude/skills/
How do I install workflow-best-practices in Claude Code?
Run npx skills add andrelandgraf/fullstackrecipes --skill workflow-best-practices -a claude-code. The skill file is at ~/.claude/skills/workflow-best-practices/SKILL.md.
What does workflow-best-practices do?
It describes how to structure workflows with orchestration, durable steps, streaming, and saved agent output.
What does workflow-best-practices require?
Complete Workflow Development Kit Setup before using these workflow practices.