agentleFS
IgorGanapolskyIgorGanapolsky/mac-yolo-safeguards/.agents/skills/gitbutler-fleet-automations/SKILL.md

gitbutler-fleet-automations

Skill3 starsChanged 4 days agoMITView on GitHub

GitButler automations for Igor's multi-agent fleet: but skill install/check, but agent setup --print, forge/AI config, stacked PRs, absorb, session branches, isolated MCP. Overlay on gitbutler-fleet-safe. Complementary to Codex #2119 gitbutler-route (do not dual-edit it). Auto-invoke on GitButler automations, but agent, but skill, but mcp, but pr auto-merge, absorb, session branch. Slash: /gitbutler-fleet-automations.

  • Commits and pushes

The file

We split this skill into the rules it gives an agent

3 rules. About 0 are common, 1 is distinctive, and 2 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈1

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 2

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Very specific:

    Do not edit tools/gitbutler-route.js (Codex PR #2119).

    line 27
  2. Distinctive:

    No global Grok GitButler MCP

    line 70
  3. Very specific:

    No Cursor hooks.json calling a missing but cursor

    line 71

≈ “Common” is an estimate: at least 1 in 5 of the 372,429 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

GitButler automations (fleet)

Official recipes (overwritten by but skill check --update): ~/.grok/skills/gitbutler. Collision wall: [[gitbutler-fleet-safe]] / Codex #2119 tools/gitbutler-route.js. Cloud login: [[gitbutler-google-sso]] (Google SSO personal Gmail; never GitHub for Cloud). Companions: [[gitbutler-mcp-isolated]], [[gitbutler-session-absorb]].

CLI measured: but 0.22.1. Doctor (live 2026-08-26): exit 0, 8 skill installs, REFUSE on ThumbGate/mac-yolo/RealEstate.

node tools/gitbutler-fleet-automations.js --demo --json
node tests/test-gitbutler-fleet-automations.js
bash ~/.grok/skills/gitbutler-fleet-automations/scripts/doctor.sh

Do not edit tools/gitbutler-route.js (Codex PR #2119). This skill is the doing layer.

Examples (show, don't tell)

Weak: Use but for all git writes.

Gold:

$ bash ~/.grok/skills/gitbutler-fleet-safe/scripts/assert_but_setup_safe.sh
REFUSE: 84 worktrees on .git. Never but setup on a multi-worktree repo.
$ node tests/test-gitbutler-fleet-automations.js
test-gitbutler-fleet-automations: PASS

Layer order

  1. gitbutler-fleet-safe / gitbutler-route — MAY I use but here? Exit 1 = git + isolated worktree.
  2. This skill — HOW this fleet automates.
  3. Official but skill — exact flags / CLI IDs.

Automations we run

AutomationCommandFleet rule
Skill install (global)but skill install --global / --detect8 agent formats at CLI version. Never put fleet rules in the official SKILL.md
Skill freshnessbut skill check--update overwrites official skill only
Agent steeringbut agent setup --printTTY wizard is but agent setup. Do not paste into sibling AGENTS.md
Session branchbut commit -b agent/<slug> -m "…" <ids>Isolated GitButler clone only. Linked worktrees use git
Absorbbut absorb <hunk-id>Unpublished own commit. Never another agent's branch
Undobut undo / but oplogPrefer over reflog
Stacked PRsbut pr new <top-branch>Isolated clone. gh pr create breaks stack metadata
Auto-mergebut pr auto-mergeSame as gh: never around ThumbGate protection
Landbut landNEVER on ThumbGate / mac-yolo main
MCPscripts/mcp_isolated.shbut mcp serve after assert_but_setup_safe.sh exit 0. Do not add [mcp_servers.gitbutler] to ~/.grok/config.toml
Cursor hooksbut cursorMissing on CLI 0.22.1 (unrecognized subcommand). Do not write ~/.cursor/hooks.json for it
Pre-push hooksdefault on but push / but pr new--no-hooks only for a proven false deny

Rubric

  • but --version = 0.22.1
  • but skill check → 8 installs, all up to date
  • doctor.sh exit 0 and REFUSE on ThumbGate / mac-yolo / RealEstate
  • No global Grok GitButler MCP
  • No Cursor hooks.json calling a missing but cursor
  • Complementary to #2119, files not dual-edited

Igor's standing ship mandate overrides GitButler's "do not push unless asked" once the task already includes PR/push.

Related

  • [[gitbutler-fleet-safe]]
  • [[gitbutler-mcp-isolated]]
  • [[gitbutler-session-absorb]]
  • [[gitbutler-google-sso]]
  • Official: ~/.grok/skills/gitbutler/SKILL.md

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.