skills.rest
jasonkuhrt
jasonkuhrtCOMMUNITY
Explore all skills by this author →
Website𝕏@JasonKuhrtGitHub

using-flo

Manage Git worktrees from GitHub issues using the flo CLI.

1|Updated Oct 21, 2016
Search Tags:#git worktree#github issues#workflow management#issue context#flo#cli tooling#pr workflow
One-click install
npx skills add https://github.com/jasonkuhrt/dotfiles --skill using-flo
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: using-flo
Source: https://github.com/jasonkuhrt/dotfiles/tree/main/claude/todo/flo/skills/using-flo
Command: npx skills add https://github.com/jasonkuhrt/dotfiles --skill using-flo

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides guidance on using the flo CLI to manage Git worktrees derived from GitHub issues, enabling starting work on issues, cleaning up after completion, and coordinating multiple parallel workstreams.

Core Features & Use Cases

  • flo [issue]: Start work - create a worktree from an issue or branch
  • flo end: End work - merge PR, delete a worktree, and sync main
  • flo list: List all active worktrees
  • flo prune: Clean up metadata for manually deleted worktrees
  • Issue mode auto: Generates .claude/issue.md with issue context and copies context cache if present

Quick Start

Start a new worktree from a GitHub issue: flo 123 Use a feature-branch workflow: flo feat/experiment View available worktrees interactively: flo

Frequently Asked Questions about using-flo

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

FAQPage Schema
How do I create a Git worktree from a GitHub issue?▼

Create a Git worktree from a GitHub issue by running the flo CLI with an issue number, which generates a dedicated worktree, issue context, and metadata for tracking the branch.

What is the best way to manage multiple parallel Git worktrees?▼

Manage multiple parallel Git worktrees using the flo list command to view active branches and flo prune to clean up metadata for manually deleted worktrees.

How do I clean up a Git worktree after merging a pull request?▼

Clean up a Git worktree after merging by running flo end, which merges the PR, deletes the worktree, and syncs the main branch automatically.

Can I start a feature branch workflow with flo instead of using an issue number?▼

Start a feature branch workflow with flo by passing a branch name like feat/experiment instead of a numeric issue ID, creating a worktree tied to that specific branch.

Does flo generate issue context for Git worktrees?▼

Flo generates a .claude/issue.md file containing GitHub issue context and copies any present context cache when creating a worktree in issue auto mode.

When should I run flo prune on my Git worktrees?▼

Run flo prune when worktrees have been manually deleted outside the CLI, leaving stale metadata that needs to be cleaned up from the active tracking list.

Related Skills

Explore More Software Engineering Skills→
kagentikagenti
292

git:status

Aggregate Git worktree status, pull request details, and TODO file summaries.

Official
Intermediate
pkuppenspkuppens
1

branch-cleanup-after-pr

Synchronize local Git branches and delete merged or obsolete ones.

Community
Intermediate
alpoxdevalpoxdev
3

git-issue

Automates GitHub issue creation and links local branches to them.

Community
Advanced
pegasus-isipegasus-isi

start

Create issue-linked git branches and worktrees via GitHub CLI.

Official
Intermediate