Agent skill

Kickoff Branch

by danielvm-git in danielvm-git/bigpowers

Create an isolated Git worktree/branch or Jujutsu workspace, then verify a clean test baseline before code.

MITAuto-check passedDevelopment

Install Kickoff Branch

skills CLI
$ npx skills add danielvm-git/bigpowers --skill kickoff-branch -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install danielvm-git/bigpowers kickoff-branch --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/danielvm-git/bigpowers.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/kickoff-branch .claude/skills/kickoff-branch && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
kickoff-branch
GitHub stars
256
Token cost
~1.4k tokens
SKILL.md length
480 words
Files
1
Skills in repo
39
Repo updated
First seen
Licence
MIT

At a glance

Create an isolated Git worktree/branch or Jujutsu workspace, then verify a clean test baseline before code.

  • Works in 6 steps: Confirm task name → Select the VCS procedure → Git pre-flight & conflict resolution → …
  • Starting a feature
  • SKILL.md covers Process and Handoff
  • Calls git, npm and bash

What it does

Kickoff Branch is an agent skill from danielvm-git/bigpowers. Create an isolated Git worktree/branch or Jujutsu workspace, then verify a clean test baseline before code. Use when starting a feature or task.

Its SKILL.md is about 1.4k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Development, covering Git worktrees. It works with Git. The repository describes itself as: Agent skills synthesizing years of software engineering discipline into a prescriptive methodology for solo developers. The licence is MIT.

When your agent uses it

  • Starting a feature
  • Tasks that involve Git worktrees

Example prompts

  • “/kickoff-branch”

Requirements

  • Python 3

Workflow steps

6 steps, taken from the step headings in SKILL.md.

  1. Confirm task name
  2. Select the VCS procedure
  3. Git pre-flight & conflict resolution
  4. Create Git worktree + branch
  5. Verify clean baseline
  6. Confirm readiness

What it can do on your machine

Read from SKILL.md and the folder at commit 812d57a. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • git
    • npm
    • bash
    • python3

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use git and npm, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Kickoff Branch loads about 1.4k tokens when it runs. Until then it costs about 40 tokens; SKILL.md has 480 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~40
When it runs · the whole SKILL.md, loaded when a task matches
~1.4k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from danielvm-git/bigpowers at commit 812d57a, republished under its MIT licence (© danielvm-git). 480 words, ~1,440 tokens.

Download SKILL.mdSave it as .claude/skills/kickoff-branch/SKILL.md (or your agent's skills folder).
name
kickoff-branch
description
Create an isolated Git worktree/branch or Jujutsu workspace, then verify a clean test baseline before code. Use when starting a feature or task.
model
haiku
effort
standard

story: e51s03

story: e20s03

story: e82s02

Kickoff Branch

HARD GATE — Direct Git work on main/master or reuse of an unrelated Jujutsu change is prohibited. Create a feature branch/worktree or Jujutsu workspace/change.

HARD GATE — Do NOT proceed with development until Preflight passes on the default branch. Red Preflight blocks branch creation and all forward work — invoke quick-fix or fix-bug per CONVENTIONS § Discovered Defects.

Create an isolated Git worktree or Jujutsu workspace before code. Preflight must be green first — solo-default owns the whole tree.

Process

1. Confirm task name

Ask if not already known: "What's the name of this feature or task?" Use it as the branch name slug (kebab-case, max 40 chars).

2. Select the VCS procedure

Read state.yaml vcs.kind. For jj, do not run the Git blocks below: verify with jj status and jj log -r '::@' -n 5, create isolation with jj workspace add ../<task-slug> -r @, then run jj -R ../<task-slug> describe -m "feat: <task>". Record the new stable change ID. For git, continue below.

2a. Anchor Git on the default branch (main or master)

HARD GATE — Git kickoff MUST start from an updated, clean default branch in the primary repository root (not a linked worktree).

bash
# Detect default branch
DEFAULT=$(git symbolic-ref refs/remotes/origin/HEAD 2>/dev/null | sed 's@^refs/remotes/origin/@@' || echo main)

git checkout "$DEFAULT"
git pull --ff-only origin "$DEFAULT"   # skip if no remote
git status                             # working tree MUST be clean
git log --oneline -5

Spec-only pre-kickoff — before enforcing the clean-tree gate, check whether dirty files are spec artifacts:

bash
DIRTY=$(git status --porcelain | awk '{print $2}')
NON_SPEC=$(echo "$DIRTY" | grep -v '^specs/' || true)

if [ -z "$DIRTY" ]; then
  : # clean — proceed
elif [ -z "$NON_SPEC" ]; then
  # spec-only dirty tree — offer auto-commit
  echo "Dirty spec artifacts: $(echo $DIRTY | tr '\n' ' ')"
  read -p "Commit spec artifacts before kickoff? [Y/n]: " CONFIRM
  CONFIRM=${CONFIRM:-Y}
  if [[ "$CONFIRM" =~ ^[Yy] ]]; then
    git add specs/
    git commit -m "chore(state): checkpoint before kickoff"
  fi
else
  echo "Dirty tree: $NON_SPEC (not a spec artifact). Stash or commit before proceeding."
  exit 1
fi
  • Spec artifacts match specs/ — state.yaml, epics YAMLs, execution-status.yaml, etc.
  • Non-spec dirty files (src/, scripts/, SKILL.md, …) still enforce the full clean-tree gate.
  • If not on $DEFAULT after checkout, stop and fix before continuing.
Show full SKILL.md (238 more words)Show less
3. Git pre-flight & conflict resolution

Before creating the worktree, verify the target environment is clean:

bash
# 1. Check for existing directory
ls -d ../<task-slug> 2>/dev/null

# 2. Check for existing branch
git branch --list <task-slug>

# 3. Check for "ghost" worktrees (metadata exists but directory is gone)
git worktree list | grep "<task-slug>"

Handling Conflicts:

  • Directory exists: If ../<task-slug> already exists, ask the user if they want to use it or delete it.
  • Branch exists: If the branch exists but no worktree is attached, ask to use the existing branch (git worktree add ../<task-slug> <task-slug>) or delete it.
  • Ghost worktree: If git worktree list shows the path but the directory is missing, run git worktree prune to clear the stale metadata. bash scripts/cleanup-worktrees.sh does this plus reports any worktree whose branch is already merged or deleted — advisory only, it prints the git worktree remove/git branch -d commands rather than running them, so review before acting.
4. Create Git worktree + branch
bash
# From the main repo root (not another worktree)
git worktree add ../<task-slug> -b <task-slug>
cd ../<task-slug>

If the user prefers a branch without a worktree:

bash
git checkout -b <task-slug>
4. Verify clean baseline

HARD GATE (e39s02): Acquire story lock in specs/agent-locks.yaml before running tests.

bash
LOCK="specs/agent-locks.yaml"; STORY="<story-id>"
if [ -f "$LOCK" ]; then
  python3 -c "
import yaml,sys,datetime
d=yaml.safe_load(open('$LOCK'))or{'locks':[]}
for l in d['locks']:
  if l['story_id']=='$STORY':print(f'LOCKED by {l[\"locked_by\"]} at {l[\"locked_at\"]}');sys.exit(1)
d['locks'].append({'story_id':'$STORY','locked_by':'agent: build-epic','locked_at':datetime.datetime.utcnow().strftime('%Y-%m-%dT%H:%M:%SZ'),'files_touched':[]})
yaml.dump(d,open('$LOCK','w'),default_flow_style=False)
print(f'LOCK ACQUIRED: $STORY')
"
fi

If locked: abort. If unlocked: entry added, proceed.

Run Preflight (from CLAUDE.md Commands table, or BP_PREFLIGHT from bash scripts/bp-read-agents.sh) and confirm green before writing any code:

bash
# Preflight — project's full local verification stack
# bigpowers example:
npm run compliance && bash scripts/run-verification-gates.sh

# Or project-specific from CLAUDE.md / AGENTS.md
  • Preflight passes (all chained gates green)
  • No type errors (npm run typecheck or equivalent, if not in Preflight)
  • No lint errors (npm run lint or equivalent, if not in Preflight)

If Preflight is red, stop — route to quick-fix or fix-bug. Fix before kickoff continues.

5. Confirm readiness

Report: ✓ Preflight green + branch + worktree. Suggest next: develop-tdd or execute-plan.

Handoff

Gate: READY -> next: develop-tdd Writes: state.yaml handoff.next_skill = develop-tdd

© danielvm-git, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/kickoff-branch of danielvm-git/bigpowers.

Open the folder on GitHubat commit 812d57a

Compare with similar skills

Kickoff Branch next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Kickoff Branch compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Kickoff Branch this skilldanielvm-git/bigpowers256—~1.4kAutomated safety check: PassMIT
Git Worktree IsolationjnMetaCode/superpowers-zh8.3k1 repos~982Automated safety check: PassMIT
WorktreeAgentsMesh/AgentsMesh2.4k—~553Automated safety check: NotesCustom licence
Cursor Composer Task DelegateChachamaru127/claude-code-harness3.2k—~4.4kAutomated safety check: NotesMIT
Git Worktree Setupk8zdev/k8z155—~930Automated safety check: PassNone
New Featuremichaelshimeles/skills1.3k1 repos~699Automated safety check: PassNone

Similar skills

  • Git Worktree Isolation

    jnMetaCode/superpowers-zh

    Sets up an isolated workspace before feature work or plan execution, preferring native worktree tools and falling back to git worktree, with instructions in Chinese.

    8.3k GitHub starsUsed in 1 repo~982 tokens
    DevelopmentAuto-check passed
  • Worktree

    AgentsMesh/AgentsMesh

    Creates or reuses an isolated AgentsMesh Git worktree from a verified base branch, preserves existing changes, and optionally starts the worktree-scoped development environment.

    2.4k GitHub stars~553 tokensUpdated 14 days ago
    DevelopmentAuto-check: notes
  • Cursor Composer Task Delegate

    Chachamaru127/claude-code-harness

    Hands one implementation task to Cursor Composer in an isolated git worktree, then reviews its diff and cherry-picks the result into the main branch.

    3.2k GitHub stars~4.4k tokensUpdated 3 days ago
    DevelopmentAuto-check: notes
  • Automate git worktree creation and copy private files (not tracked in git) to new workdirs.

    155 GitHub stars~930 tokensUpdated 3 mo ago
    DevelopmentAuto-check passed
  • New Feature

    michaelshimeles/skills

    Start a new task in an isolated Git worktree branched from origin/main so multiple agents can work on the same repo in parallel without conflicts.

    1.3k GitHub starsUsed in 1 repo~699 tokens
    DevelopmentAuto-check passed
  • Use Mori CLI to enable agent-to-agent communication and coordination across Mori-managed panes.

    303 GitHub stars~1.7k tokensUpdated 2 mo ago
    DevelopmentAuto-check passed

More from danielvm-git/bigpowers

All 39 skills in this repo
  • Extract Design

    danielvm-git/bigpowers

    Extract a Google DESIGN.md file from an HTML prototype (claude.ai/design or any styled page) using Puppeteer, producing machine-readable tokens and AI-generated prose.

    256 GitHub stars~1k tokensUpdated 16 days ago
    Auto-check passed
  • Align Grid

    danielvm-git/bigpowers

    Build editorial/magazine/report webpages on a GENUINE Müller-Brockmann modular grid (International Typographic Style) — not a decorative one.

    256 GitHub stars~3k tokensUpdated 16 days ago
    Auto-check passed
  • Assess Impact

    danielvm-git/bigpowers

    Analyze the blast radius of a proposed change before any code is written.

    256 GitHub stars~766 tokensUpdated 16 days ago
    Auto-check passed
  • Audit Code

    danielvm-git/bigpowers

    Self-review checklist for the coding agent to run before dispatching a reviewer.

    256 GitHub stars~1.6k tokensUpdated 16 days ago
    Auto-check: notes
  • Audit Plan

    danielvm-git/bigpowers

    Evaluate an incoming project plan against bigpowers principles and conventions, surface gaps, and produce a READY/NOT READY verdict before engagement begins.

    256 GitHub stars~880 tokensUpdated 16 days ago
    Auto-check passed
  • Compose Workflow

    danielvm-git/bigpowers

    Chain multiple bigpowers skills into a custom workflow recipe saved in specs/.

    256 GitHub stars~723 tokensUpdated 16 days ago
    Auto-check passed

Works with

Questions about Kickoff Branch

What does Kickoff Branch do?

Create an isolated Git worktree/branch or Jujutsu workspace, then verify a clean test baseline before code. Kickoff Branch is an agent skill from danielvm-git/bigpowers. Create an isolated Git worktree/branch or Jujutsu workspace, then verify a clean test baseline before code.

When should I use Kickoff Branch?

Kickoff Branch fits situations like: starting a feature; tasks that involve Git worktrees.

How do I install Kickoff Branch in Claude Code?

Run `npx skills add danielvm-git/bigpowers --skill kickoff-branch -a claude-code`. Or copy the skill folder (skills/kickoff-branch in danielvm-git/bigpowers) into .claude/skills/kickoff-branch in your project. Claude Code loads it when a task matches its description.

How do I install Kickoff Branch in Codex?

Run `npx skills add danielvm-git/bigpowers --skill kickoff-branch -a codex`. Or copy the skill folder (skills/kickoff-branch in danielvm-git/bigpowers) into .agents/skills/kickoff-branch in your project. Codex loads it when a task matches its description.

Can I use Kickoff Branch in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add danielvm-git/bigpowers --skill kickoff-branch -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/kickoff-branch, .gemini/skills/kickoff-branch, .github/skills/kickoff-branch and .opencode/skills/kickoff-branch in your project.

What does Kickoff Branch need to run?

Going by SKILL.md and its folder, Kickoff Branch needs the command-line tools its instructions call (git, npm, bash and python3). Our summary lists: Python 3.

Does Kickoff Branch access the network?

SKILL.md contains no URLs. Its commands use git and npm, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Kickoff Branch safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Kickoff Branch use?

Kickoff Branch is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Kickoff Branch use?

About 1.4k tokens (SKILL.md is roughly 5.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Kickoff Branch?

Skills that share tags, products or a category with Kickoff Branch: Git Worktree Isolation (jnMetaCode/superpowers-zh, 8.3k stars), Worktree (AgentsMesh/AgentsMesh, 2.4k stars), Cursor Composer Task Delegate (Chachamaru127/claude-code-harness, 3.2k stars) and Git Worktree Setup (k8zdev/k8z, 155 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Kickoff Branch?

danielvm-git (a GitHub user) maintains it in danielvm-git/bigpowers, which has 256 GitHub stars. The repository holds 39 skills in this directory. The repository was last updated on September 21, 2026.

Source: danielvm-git/bigpowers on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.