# workflow-best-practices

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.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 104 installs · ★ 23 repo stars
- Author: andrelandgraf
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/andrelandgraf/fullstackrecipes/tree/HEAD/skills/workflow-best-practices/SKILL.md
- Updated: 2026-06-08
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/workflow-best-practices

## What it does

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.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add andrelandgraf/fullstackrecipes --skill workflow-best-practices -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/workflow-best-practices/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/workflow-best-practices/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add andrelandgraf/fullstackrecipes --skill workflow-best-practices -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/workflow-best-practices/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add andrelandgraf/fullstackrecipes --skill workflow-best-practices -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/workflow-best-practices/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install andrelandgraf/fullstackrecipes skills/workflow-best-practices
```

2. **Manually: put the files in place**
- File: `.github/skills/workflow-best-practices/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add andrelandgraf/fullstackrecipes --skill workflow-best-practices -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/andrelandgraf/fullstackrecipes --path skills/workflow-best-practices
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/workflow-best-practices/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add andrelandgraf/fullstackrecipes --skill workflow-best-practices -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/andrelandgraf/fullstackrecipes/tree/HEAD/skills/workflow-best-practices/SKILL.md

## When to use it
- 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
- 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.

## Similar
- [find-skills](https://affpapa.org/en/nevibecode/skills/find-skills.md) — skill · 4400000 installs
- [frontend-design](https://affpapa.org/en/nevibecode/skills/frontend-design.md) — skill · 1025790 installs
- [agent-browser](https://affpapa.org/en/nevibecode/skills/vercel-labs-agent-browser.md) — skill · 1600000 installs
- [design-taste-frontend](https://affpapa.org/en/nevibecode/skills/design-taste-frontend.md) — skill · 802600 installs
- [grill-me](https://affpapa.org/en/nevibecode/skills/grill-me.md) — skill · 1424476 installs
- [grill-with-docs](https://affpapa.org/en/nevibecode/skills/grill-with-docs.md) — skill · 1219756 installs

From the same set: [andrelandgraf/fullstackrecipes](https://affpapa.org/en/nevibecode/by/andrelandgraf/fullstackrecipes.md) — 9 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
