Agent skill

using-flo

Guidance for using the flo CLI to manage git worktrees from GitHub issues. Use when starting work on issues, cleaning up finished work, or managing multiple parallel workstreams.

View SKILL.md on GitHub Repository
Stars 163
Forks 31

Install this agent skill to your Project

npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/data/using-flo

SKILL.md

Using Flo

Flo creates git worktrees from GitHub issues with automatic Claude context setup.

Commands

Command Purpose
flo [issue] Start work - create worktree from issue or branch
flo end End work - merge PR, delete worktree, sync main
flo list List all worktrees
flo prune Clean up metadata for manually deleted worktrees

Starting Work

fish
# From GitHub issue (fetches issue, creates branch, sets up Claude context)
flo 123

# From branch name (no GitHub integration)
flo feat/experiment

# Interactive picker (shows open issues)
flo

Issue mode auto:

  • Assigns issue to you
  • Creates branch: feat/123-title, fix/123-title, etc.
  • Generates .claude/issue.md with issue context
  • Copies Serena cache if present
  • Runs pnpm install

Ending Work

fish
# Merge PR, delete worktree/branch, sync main (default)
flo end

# Abandon work (close PR without merging)
flo end --resolve abort

# Skip validations (dirty worktree, failing checks)
flo end --force

# Clean up locally, don't touch PR
flo end --ignore pr

# Preview without executing
flo end --dry

Worktree Layout

~/projects/myproject/                    (main repo)
~/projects/myproject_feat-123-add-auth/  (worktree)
~/projects/myproject_fix-456-bug/        (worktree)

Notes

  • Always use flo end (not rm -rf) to clean up worktrees
  • If you did rm -rf, run flo prune to clean git metadata
  • Run flo -h or flo <command> -h for detailed help

Recommended Agent Skills

Expand your agent's capabilities with these related and highly-rated skills.

majiayu000/claude-skill-registry

agent-ops-spec

Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.

163 31
Explore
majiayu000/claude-skill-registry

agent-ops-state

Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.

163 31
Explore
majiayu000/claude-skill-registry

agent-ops-spec

Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.

163 31
Explore
majiayu000/claude-skill-registry

agent-ops-testing

Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.

163 31
Explore
majiayu000/claude-skill-registry

agent-ops-testing

Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.

163 31
Explore
majiayu000/claude-skill-registry

agent-ops-state

Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.

163 31
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results