Back to Skills

flow-work

verified

Execute a plan file or Beads epic systematically with git setup, task tracking, quality checks, and commit workflow. Use when implementing a plan, working through a spec, following documented steps, or executing a Beads issue ID (e.g., bd-123, gno-45, app-12).

View on GitHub

Marketplace

gmickel-claude-marketplace

gmickel/gmickel-claude-marketplace

Plugin

flow

Repository

gmickel/gmickel-claude-marketplace
452stars

plugins/flow/skills/flow-work/SKILL.md

Last Verified

January 25, 2026

Install Skill

Select agents to install to:

Scope:
npx add-skill https://github.com/gmickel/gmickel-claude-marketplace/blob/main/plugins/flow/skills/flow-work/SKILL.md -a claude-code --skill flow-work

Installation paths:

Claude
.claude/skills/flow-work/
Powered by add-skill CLI

Instructions

# Flow work

Execute a plan systematically. Focus on finishing.

**Role**: execution lead, plan fidelity first.
**Goal**: complete every plan step in order with tests.

## Input

Full request: #$ARGUMENTS

Accepts:
- Plan file: `plans/<slug>.md`
- Beads ID(s) or title(s) directly
- Chained instructions like "then review with /flow:impl-review"

Examples:
- `/flow:work plans/oauth.md`
- `/flow:work gno-40i`
- `/flow:work gno-40i then review via /flow:impl-review and fix issues`

If no plan/ID provided, ask for it.

## FIRST: Setup Questions (REQUIRED)

**Before doing anything else**, output these questions as text (do NOT use AskUserQuestion tool):

Check if rp-cli available: `which rp-cli >/dev/null 2>&1`

If rp-cli available, ask both:
```
Quick setup before starting:

1. **Branch** — Where to work?
   a) Current branch
   b) New branch
   c) Isolated worktree

2. **Review** — Run Carmack-level review after?
   a) Yes, RepoPrompt chat
   b) Yes, export for external LLM (ChatGPT, Claude web)
   c) No

(Reply: "1a 2a", "current branch, export review", or just tell me naturally)
```

If rp-cli NOT available, ask only branch:
```
Quick setup: Where to work?
a) Current branch  b) New branch  c) Isolated worktree

(Reply: "a", "current", or just tell me)
```

Wait for response. Parse naturally — user may reply terse or ramble via voice.
**Do NOT read files or write code until user responds.**

## Workflow

After setup questions answered, read [phases.md](phases.md) and execute each phase in order.
If user chose review:
- Option 2a: run `/flow:impl-review` after Phase 6, fix issues until it passes
- Option 2b: run `/flow:impl-review` with export mode after Phase 6

## Guardrails

- Don't start without asking branch question
- Don't start without plan
- Don't skip tests
- Don't leave tasks half-done

Validation Details

Front Matter
Required Fields
Valid Name Format
Valid Description
Has Sections
Allowed Tools
Instruction Length:
1782 chars