skills.rest
benkruger
benkrugerCOMMUNITY
Explore all skills by this author →
GitHub

flow-start

Create a worktree, upgrade dependencies, open a pull request, and initialize flow state.

25|3|Updated Feb 19, 2026
Search Tags:#workflow#worktree#flow#feature#claude-code#pull-request#start
One-click install
npx skills add https://github.com/benkruger/flow --skill flow-start
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: flow-start
Source: https://github.com/benkruger/flow/tree/main/skills/flow-start
Command: npx skills add https://github.com/benkruger/flow --skill flow-start

SYSTEM DOCUMENTATION & REQUIREMENTS

## What problem does it solve? This skill automates the initial setup for a new feature by creating a worktree, upgrading dependencies, opening a pull request, and initializing .flow-states/<branch>/state.json and configuring the workspace.

## Core Features & Use Cases

  • Automates feature-start setup: creates a dedicated worktree, upgrades dependencies, opens a pull request, and writes the initial flow state.
  • Branch derivation and state tracking: derives a branch name from the prompt and initializes a project-scoped state store for concurrent work.
  • Safe, guided workflow: coordinates start-init and flow-start steps with lock management and workspace preparation for consistent environments.

### Quick Start Invoke /flow:flow-start with your feature name to create a worktree, upgrade dependencies, open a PR, and initialize the FLOW state for the new feature.

Frequently Asked Questions about flow-start

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate worktree creation and pull request setup for a new feature?▼

You can automate feature-start setup by invoking a single command that creates a dedicated worktree, upgrades dependencies, opens a pull request, and initializes the flow state. This prepares an isolated environment for concurrent work.

How does branch derivation work when starting a new feature workflow?▼

Branch derivation works by automatically generating a branch name from your feature prompt. It ensures argument sanitization and initializes a project-scoped state store at .flow-states/<branch>/state.json for tracking.

Can I use a plan-first TDD workflow with Claude Code projects?▼

Yes, this workflow enables a plan-first, TDD workflow for Claude Code projects across supported languages. It coordinates start-init and flow-start steps with lock management to ensure consistent environments.

Do I need to manage dependency upgrades manually when creating a new worktree?▼

No, you do not need to manage dependency upgrades manually. The automated setup handles lock management and upgrades dependencies automatically when creating the worktree for your new feature.

What is the best way to prepare an isolated environment for concurrent feature development?▼

The best way to prepare an isolated environment is to use an automated feature-start command that configures the workspace, derives a branch name, and initializes post-start state tracking for concurrent work.

Related Skills

Explore More Software Engineering Skills→
jkomorosjkomoros
9

session-startup

Initialize Claude Code sessions by fetching updates, loading workspace config, and starting servers.

Community
Basic
TioSavichTioSavich

ship

Merge base branch, run tests, bump version, update changelog, commit, push, and create a pull request.

Community
Advanced
aoxendine3aoxendine3

pr-polish

Coordinate automated GitHub pull request review and merge readiness cycles.

Community
Advanced
maragudkmaragudk
48

worktrees

Create isolated git worktrees for parallel development tasks.

Official
Advanced