Agent skill

Ff Worktrees

by damus-io in damus-io/damus

Fast-forward master and every git worktree branch up to a target ref (default github/master), skipping any worktree with unmerged commits.

GPL-3.0Auto-check passedDevelopment

Install Ff Worktrees

skills CLI
$ npx skills add damus-io/damus --skill ff-worktrees -a claude-code

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

GitHub CLI
$ gh skill install damus-io/damus ff-worktrees --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/damus-io/damus.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/ff-worktrees .claude/skills/ff-worktrees && 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
ff-worktrees
GitHub stars
2.1k
Token cost
~451 tokens
SKILL.md length
180 words
Files
1
Skills in repo
3
Repo updated
First seen
Licence
GPL-3.0

At a glance

Fast-forward master and every git worktree branch up to a target ref (default github/master), skipping any worktree with unmerged commits.

  • The user wants to sync/update their worktree branches to latest master — e.g
  • SKILL.md covers Running it and Behavior
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • Tasks that involve Git worktrees

What it does

Ff Worktrees is an agent skill from damus-io/damus. Fast-forward master and every git worktree branch up to a target ref (default github/master), skipping any worktree with unmerged commits. Use when the user wants to sync/update their worktree branches to latest master — e.g. "/ff-worktrees", "ff all worktrees to github/master", "fast-forward the worktrees".

Its SKILL.md is about 450 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 GitHub, Git and Bitcoin. The licence is GPL-3.0.

When your agent uses it

  • The user wants to sync/update their worktree branches to latest master — e.g
  • Tasks that involve Git worktrees

Example prompts

  • “/ff-worktrees”
  • “ff all worktrees to github/master”
  • “fast-forward the worktrees”
  • “/ff-worktrees”

What it can do on your machine

Read from SKILL.md and the folder at commit 4a94f66. 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

    No scripts in the folder and no shell commands in SKILL.md (its code samples are bash).

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

  • Network

    No URLs in SKILL.md.

    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

Ff Worktrees loads about 451 tokens when it runs. Until then it costs about 81 tokens; SKILL.md has 180 words of instructions outside code blocks.

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

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 damus-io/damus at commit 4a94f66, republished under its GPL-3.0 licence (© damus-io). 180 words, ~451 tokens.

Download SKILL.mdSave it as .claude/skills/ff-worktrees/SKILL.md (or your agent's skills folder).
name
ff-worktrees
description
Fast-forward master and every git worktree branch up to a target ref (default github/master), skipping any worktree with unmerged commits. Use when the user wants to sync/update their worktree branches to latest master — e.g. "/ff-worktrees", "ff all worktrees to github/master", "fast-forward the worktrees".

ff-worktrees

Fast-forwards master and every branch checked out in a git worktree up to a target ref. Only true fast-forwards are applied: a branch is advanced solely when it is already an ancestor of the target. Worktree branches carrying their own unmerged commits are left untouched and reported as skipped, so no work is ever clobbered.

Running it

bash
devtools/ff-worktrees.sh [target]
  • target — ref to fast-forward toward. Defaults to github/master — this repo's remote is named github, not origin. When it looks like <remote>/<branch> and <remote> is configured, the remote is fetched first.

Examples:

bash
devtools/ff-worktrees.sh                 # ff everything to github/master
devtools/ff-worktrees.sh monad/master    # ff everything to monad/master

Behavior

  • Fetches the target's remote first (when the target is <remote>/<branch>).
  • Fast-forwards each branch in place inside its worktree via merge --ff-only; untracked files and non-conflicting local edits survive.
  • A branch not checked out in any worktree (e.g. master when it's idle) has its ref moved directly, still guarded by an ancestry (fast-forward) check.
  • Reports a one-line summary per branch: + advanced, = already up to date, ~ skipped for unmerged commits, ! skipped because a dirty worktree blocks the fast-forward.

Safe to run from any worktree — it never resets a branch or discards commits.

© damus-io, GPL-3.0. 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 .claude/skills/ff-worktrees of damus-io/damus.

Open the folder on GitHubat commit 4a94f66

Used in 1 other repository

We found 1 copy of this SKILL.md (exact, near-identical or edited) in other folders. This page covers the copy in damus-io/damus, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Ff Worktrees 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.

Ff Worktrees compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Ff Worktrees this skilldamus-io/damus2.1k—~451Automated safety check: PassGPL-3.0
Pre-Release PR Triagejamiepine/voicebox57k—~3.1kAutomated safety check: PassMIT
Clean Complete Branchesjtenniswood/espcontrol1.1k—~820Automated safety check: PassCustom licence
Clean Merged Branch Foldersjtenniswood/espcontrol1.1k—~813Automated safety check: PassCustom licence
Fixexercism/website550—~1.2kAutomated safety check: NotesAGPL-3.0
Kanvibe Release Deployrookedsysc/kanvibe143—~12kAutomated safety check: NotesAGPL-3.0

Similar skills

  • Pre-Release PR Triage

    jamiepine/voicebox

    Sorts a backlog of open pull requests into must-merge, candidate, superseded and deferred, writes a triage doc and works the merge loop before a release.

    57k GitHub stars~3.1k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Clean Complete Branches

    jtenniswood/espcontrol

    Clean up completed Git branches and worktrees for this repository both locally and on GitHub.

    1.1k GitHub stars~820 tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Clean Merged Branch Folders

    jtenniswood/espcontrol

    Clean up local branch worktree folders for this repository after their branches or pull requests have merged to main.

    1.1k GitHub stars~813 tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Fix

    exercism/website

    Fix a GitHub issue end-to-end — fetches issue, creates worktree, plans and implements fix, runs validation, opens PR, cleans up.

    550 GitHub stars~1.2k tokensUpdated yesterday
    DevelopmentAuto-check: notes
  • Kanvibe Release Deploy

    rookedsysc/kanvibe

    A skill your agent uses whenever releasing or deploying KanVibe desktop from a clean, up-to-date dev checkout: ask only for the target version and release-note approval, then let the AI update…

    143 GitHub stars~12k tokensUpdated today
    DevelopmentAuto-check: notes
  • Kc Issue

    imran31415/kube-coder

    Spin up an isolated agent to work a GitHub issue of kube-coder or any other repo checked out in the workspace.

    388 GitHub stars~1.9k tokensUpdated yesterday
    DevelopmentAuto-check: notes

More from damus-io/damus

  • Process conversations or chat logs to identify reported bugs, search for existing GitHub issues, update existing issues when new undocumented details are discovered, and create new issues for…

    2.1k GitHub stars~2k tokensUpdated 27 days ago
    Auto-check passed
  • Prepare the CHANGELOG.md for a Damus release by running the changelog script, curating the output, and committing the result.

    2.1k GitHub stars~1.1k tokensUpdated 27 days ago
    Auto-check passed

Categories

Questions about Ff Worktrees

What does Ff Worktrees do?

Fast-forward master and every git worktree branch up to a target ref (default github/master), skipping any worktree with unmerged commits. Ff Worktrees is an agent skill from damus-io/damus. Fast-forward master and every git worktree branch up to a target ref (default github/master), skipping any worktree with unmerged commits.

When should I use Ff Worktrees?

Ff Worktrees fits situations like: the user wants to sync/update their worktree branches to latest master — e.g; tasks that involve Git worktrees.

How do I install Ff Worktrees in Claude Code?

Run `npx skills add damus-io/damus --skill ff-worktrees -a claude-code`. Or copy the skill folder (.claude/skills/ff-worktrees in damus-io/damus) into .claude/skills/ff-worktrees in your project. Claude Code loads it when a task matches its description.

How do I install Ff Worktrees in Codex?

Run `npx skills add damus-io/damus --skill ff-worktrees -a codex`. Or copy the skill folder (.claude/skills/ff-worktrees in damus-io/damus) into .agents/skills/ff-worktrees in your project. Codex loads it when a task matches its description.

Can I use Ff Worktrees 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 damus-io/damus --skill ff-worktrees -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/ff-worktrees, .gemini/skills/ff-worktrees, .github/skills/ff-worktrees and .opencode/skills/ff-worktrees in your project.

What does Ff Worktrees need to run?

SKILL.md names no scripts, command-line tools or credentials: Ff Worktrees is instructions for the agent only.

Does Ff Worktrees access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Ff Worktrees 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 Ff Worktrees use?

Ff Worktrees is published under the GPL-3.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Ff Worktrees use?

About 451 tokens (SKILL.md is roughly 1.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 Ff Worktrees?

Skills that share tags, products or a category with Ff Worktrees: Pre-Release PR Triage (jamiepine/voicebox, 57k stars), Clean Complete Branches (jtenniswood/espcontrol, 1.1k stars), Clean Merged Branch Folders (jtenniswood/espcontrol, 1.1k stars) and Fix (exercism/website, 550 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Ff Worktrees?

damus-io (a GitHub organization) maintains it in damus-io/damus, which has 2,145 GitHub stars. The repository holds 3 skills in this directory. The repository was last updated on September 11, 2026.

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