New: 97,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Graphite

by UsefulSoftwareCo in UsefulSoftwareCo/executor

Manage Git branches and PRs using Graphite CLI (gt) instead of raw git commands.

MITAuto-check passedDevelopment

Install Graphite

skills CLI
$ npx skills add UsefulSoftwareCo/executor --skill graphite -a claude-code

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

GitHub CLI
$ gh skill install UsefulSoftwareCo/executor graphite --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/UsefulSoftwareCo/executor.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.skills/graphite .claude/skills/graphite && 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
graphite
GitHub stars
4.1k
Token cost
~2.6k tokens
SKILL.md length
1,266 words
Files
1
Skills in repo
21
Repo updated
First seen
Licence
MIT

At a glance

Manage Git branches and PRs using Graphite CLI (gt) instead of raw git commands.

  • Works in 5 steps: git status to find conflicted files. → Resolve the <<<<<<< / ======= / >>>>>>>… → Stage with gt add -A (or git add ). → …
  • Committing code changes
  • SKILL.md covers Prefer gt over git, Interactivity (for agents), Rebase Conflicts and Global Flags, plus 6 more sections
  • Calls git

What it does

Graphite is an agent skill from UsefulSoftwareCo/executor. Manage Git branches and PRs using Graphite CLI (gt) instead of raw git commands. Use this skill when committing code changes, amending commits, creating branches, or submitting pull requests. Triggers on git commit, git push, creating PRs, amending changes, stacking branches, or any version control workflow.

Its SKILL.md is about 2.6k 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 workflow, Commit messages and Pull requests. It works with Git. The repository describes itself as: The missing integration layer for AI agents. Let them call any OpenAPI / MCP / GraphQL / custom js functions in secure environment. The licence is MIT.

When your agent uses it

  • Committing code changes
  • Amending commits
  • Creating branches
  • Submitting pull requests

Example prompts

  • “/graphite”

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. git status to find conflicted files.
  2. Resolve the <<<<<<< / ======= / >>>>>>> markers.
  3. Stage with gt add -A (or git add ).
  4. Run gt continue — never git rebase --continue. Graphite tracks its own rebase state; using raw git desyncs it.
  5. Verify the stack once continue completes (gt log, run tests).

What it can do on your machine

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

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

  • Network

    No URLs in SKILL.md. Its commands use git, 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

Graphite loads about 2.6k tokens when it runs. Until then it costs about 80 tokens; SKILL.md has 1,266 words of instructions outside code blocks.

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

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 UsefulSoftwareCo/executor at commit 27dccb8, republished under its MIT licence (© UsefulSoftwareCo). 1,266 words, ~2,554 tokens.

Download SKILL.mdSave it as .claude/skills/graphite/SKILL.md (or your agent's skills folder).
name
graphite
description
Manage Git branches and PRs using Graphite CLI (gt) instead of raw git commands. Use this skill when committing code changes, amending commits, creating branches, or submitting pull requests. Triggers on git commit, git push, creating PRs, amending changes, stacking branches, or any version control workflow.

Graphite CLI Command Reference

Prefer gt over git

Use gt commands instead of their git counterparts for commit and branch management. Raw git bypasses Graphite's stack metadata, leaving descendants un-restacked and the CLI's view of the stack out of sync.

Instead ofUse
git checkout -b <name>gt create <name>
git commit -m "msg"gt modify -c -m "msg"
git commit --amendgt modify --amend
git commit -am "msg"gt modify -cam "msg"

Why: gt keeps stack metadata consistent and auto-restacks descendant branches when a parent changes.

Interactivity (for agents)

Several commands are interactive by default and will hang without a TTY: gt modify, gt move, gt split, gt restack, gt checkout (no arg), gt submit.

  • Always pass explicit args/flags: gt move --onto <branch>, gt modify -m "msg", gt checkout <branch>, gt submit --no-interactive.
  • Add --no-interactive (or --quiet) to skip prompts.
  • If a command genuinely needs input that can't be supplied via flags (e.g. complex rebase conflict resolution), stop and notify the user rather than guessing.

Rebase Conflicts

When gt restack, gt move, gt sync, etc. pause on a conflict:

  1. git status to find conflicted files.
  2. Resolve the <<<<<<< / ======= / >>>>>>> markers.
  3. Stage with gt add -A (or git add <file>).
  4. Run gt continue — never git rebase --continue. Graphite tracks its own rebase state; using raw git desyncs it.
  5. Verify the stack once continue completes (gt log, run tests).

To bail out: gt abort.

Global Flags

  • --help - Show help for a command
  • --cwd - Working directory for operations
  • --debug - Write debug output
  • --interactive / --no-interactive - Enable/disable prompts (default: enabled)
  • --verify / --no-verify - Enable/disable git hooks (default: enabled)
  • --quiet - Minimize output, implies --no-interactive

Branch Creation & Modification

gt create [name]

Create a new branch stacked on current branch with staged changes.

Flags:

  • -a, --all - Stage all unstaged changes including untracked files
  • -m, --message - Commit message
  • -i, --insert - Insert between current branch and its child
  • -p, --patch - Pick hunks to stage
  • -u, --update - Stage updates to tracked files only
  • -v, --verbose - Show diff in commit template
  • --ai / --no-ai - AI-generate branch name and message
gt modify

Amend current branch's commit or create new commit. Auto-restacks descendants.

Flags:

  • -a, --all - Stage all changes
  • -c, --commit - Create new commit instead of amending
  • -e, --edit - Open editor for commit message
  • -m, --message - New commit message
  • -p, --patch - Pick hunks to stage
  • -u, --update - Stage tracked file updates
  • --into - Amend into specified downstack branch
  • --interactive-rebase - Start git interactive rebase
  • --reset-author - Set commit author to current user
gt absorb

Amend staged changes to relevant commits in current stack.

Flags:

  • -a, --all - Stage all unstaged changes (not untracked)
  • -d, --dry-run - Print what would happen
  • -f, --force - Skip confirmation
  • -p, --patch - Pick hunks to stage
gt squash

Squash all commits in current branch into single commit.

Flags:

  • -m, --message - Commit message
  • --edit - Modify existing message
  • -n, --no-edit - Keep existing message
gt fold

Fold branch's changes into parent, restack descendants.

Flags:

  • -k, --keep - Keep current branch name instead of parent's
gt split

Split current branch into multiple branches.

Flags:

  • -c, --commit, --by-commit - Split by commit history
  • -h, --hunk, --by-hunk - Split by hunk interactively
  • -f, --file, --by-file - Split files matching pathspecs

Submitting PRs

gt submit

Push branches and create/update PRs on GitHub.

Flags:

  • -s, --stack - Include descendant branches
  • -d, --draft - Create PRs as drafts
  • -p, --publish - Publish draft PRs
  • -e, --edit / -n, --no-edit - Edit/skip PR metadata
  • --edit-title / --no-edit-title - Edit/skip title
  • --edit-description / --no-edit-description - Edit/skip description
  • -r, --reviewers - Set reviewers (comma-separated or prompt)
  • -t, --team-reviewers - Team slugs for review
  • -m, --merge-when-ready - Auto-merge when requirements met
  • -c, --confirm - Confirm before submitting
  • --dry-run - Report what would happen
  • -f, --force - Force push (vs --force-with-lease)
  • -u, --update-only - Only update existing PRs
  • -v, --view - Open PR in browser after
  • -w, --web - Edit metadata in browser
  • --cli - Edit metadata via CLI
  • --ai / --no-ai - AI-generate title/description
  • --comment - Add comment to PR
  • --restack - Restack before submitting
  • --rerequest-review - Rerequest from current reviewers
  • --always - Push even if unchanged
  • --branch - Run from specified branch
  • --target-trunk - PR target trunk
gt merge

Merge PRs from trunk to current branch via Graphite.

Flags:

  • -c, --confirm - Confirm before merging
  • --dry-run - Report what would merge

Navigation

gt checkout [branch]

Switch to branch. Interactive selector if no branch provided.

Flags:

  • -a, --all - Show all trunks in selection
  • -u, --show-untracked - Include untracked branches
  • -s, --stack - Only show current stack
  • -t, --trunk - Checkout trunk
gt up [steps]

Switch to child of current branch.

Flags:

  • -n, --steps - Levels to traverse
  • --to - Target branch to navigate toward
gt down [steps]

Switch to parent of current branch.

Flags:

  • -n, --steps - Levels to traverse
gt top

Switch to tip of current stack. Prompts if ambiguous.

Show full SKILL.md (510 more words)Show less
gt bottom

Switch to branch closest to trunk in current stack.

Stack Management

gt restack

Ensure each branch has parent in Git history, rebasing if needed.

Flags:

  • --branch - Run from specified branch
  • --downstack - Only restack branch and ancestors
  • --upstack - Only restack branch and descendants
  • --only - Only restack this branch
gt move

Rebase current branch onto target, restack descendants.

Flags:

  • -o, --onto - Target branch
  • --source - Branch to move (default: current)
  • -a, --all - Show all trunks in selection
gt reorder

Reorder branches between trunk and current via editor.

Syncing

gt sync

Sync all branches with remote, clean merged/closed PRs, restack.

Flags:

  • -a, --all - Sync across all trunks
  • -f, --force - Skip confirmations
  • --restack / --no-restack - Restack after sync (default: true)
gt get [branch]

Sync branches from trunk to specified branch/PR from remote.

Flags:

  • -d, --downstack - Don't sync upstack branches
  • -f, --force - Overwrite with remote
  • --restack / --no-restack - Restack after (default: true)
  • -U, --unfrozen - Checkout as unfrozen

Branch Operations

gt delete [name]

Delete branch and Graphite metadata. Children restack to parent.

Flags:

  • -f, --force - Delete even if not merged/closed
  • -c, --close - Close associated PR on GitHub
  • --downstack - Also delete ancestors
  • --upstack - Also delete children
gt rename [name]

Rename branch. Removes PR association.

Flags:

  • -f, --force - Allow rename with open PR
gt track [branch]

Start tracking branch with Graphite by selecting parent.

Flags:

  • -f, --force - Use most recent tracked ancestor as parent
  • -p, --parent - Specify parent branch
gt untrack [branch]

Stop tracking branch. Children also untracked.

Flags:

  • -f, --force - Skip confirmation
gt pop

Delete current branch but keep working tree state.

gt freeze [branch]

Freeze branch and downstack - prevents local modifications.

gt unfreeze [branch]

Unfreeze branch and upstack.

Information

gt log [command]

Show stacks. Forms: gt log, gt log short, gt log long.

Flags:

  • -a, --all - Show all trunks
  • -r, --reverse - Print upside down
  • -u, --show-untracked - Include untracked
  • -s, --stack - Only current stack
  • -n, --steps - Levels to show (implies --stack)
  • --classic - Old style
gt info [branch]

Display branch information.

Flags:

  • -b, --body - Show PR body
  • -d, --diff - Show diff vs parent
  • -p, --patch - Show commit changes
  • -s, --stat - Show diffstat
gt parent / gt children / gt trunk

Show parent, children, or trunk of current branch.

gt trunk flags:

  • --add - Add trunk
  • -a, --all - Show all trunks
gt pr [branch]

Open PR page for branch or PR number.

Flags:

  • --stack - Open stack page

Conflict Resolution

gt continue

Continue command halted by rebase conflict.

Flags:

  • -a, --all - Stage all changes first
gt abort

Abort current command halted by conflict.

Flags:

  • -f, --force - Skip confirmation
gt undo

Undo most recent Graphite mutations.

Flags:

  • -f, --force - Skip confirmation

Setup

gt init

Initialize Graphite by selecting trunk branch.

Flags:

  • --trunk - Trunk branch name
  • --reset - Untrack all branches
gt auth

Add auth token for GitHub.

Flags:

gt config

Configure Graphite CLI (interactive).

gt upgrade

Update CLI to latest stable version.

Git Passthroughs

These pass arguments directly to git:

  • gt add [args..]
  • gt cherry-pick [args..]
  • gt rebase [args..]
  • gt reset [args..]
  • gt restore [args..]
gt revert [sha]

Create branch reverting a trunk commit.

Flags:

  • -e, --edit - Edit commit message

© UsefulSoftwareCo, 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/graphite of UsefulSoftwareCo/executor.

Open the folder on GitHubat commit 27dccb8

Compare with similar skills

Graphite 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.

Graphite compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Graphite this skillUsefulSoftwareCo/executor4.1k—~2.6kAutomated safety check: PassMIT
Git Workflow and Versioningaddyosmani/agent-skills102k2 repos~3.5kAutomated safety check: NotesMIT
React Router Pull Request Creatorremix-run/react-router57k—~2.5kAutomated safety check: PassMIT
Emoji Commit ConventionsbaptisteArno/typebot.io11k—~424Automated safety check: PassCustom licence
Draft Pull Request Creatorwordpress-mobile/WordPress-Android3.2k—~881Automated safety check: NotesGPL-2.0
Adk Gitgoogle/adk-python22k—~1.3kAutomated safety check: PassApache-2.0

Similar skills

  • Git Workflow and Versioning

    addyosmani/agent-skills

    Sets git habits for every change: short-lived branches, atomic commits with descriptive messages, clean pull requests, plus versioning, tagging and changelogs for releases.

    102k GitHub starsUsed in 2 repos~3.5k tokens
    DevelopmentAuto-check: notes

  • React Router Pull Request Creator

    remix-run/react-router

    Packages finished React Router work into a draft pull request: branch, commit, push, a written PR body and the right GitHub labels.

    57k GitHub stars~2.5k tokensUpdated yesterday
    DevelopmentAuto-check passed

  • Emoji Commit Conventions

    baptisteArno/typebot.io

    Sets the repository's convention for commit messages and pull request titles: one emoji prefix for the main intent, a concise title and clean follow-up commits.

    11k GitHub stars~424 tokensUpdated yesterday
    DevelopmentAuto-check passed

  • Draft Pull Request Creator

    wordpress-mobile/WordPress-Android

    Commits and pushes current changes, writes a pull request title and body from the branch history and template, and opens a draft PR on GitHub after you approve it.

    3.2k GitHub stars~881 tokensUpdated today
    DevelopmentAuto-check: notes

  • Adk Git

    google/adk-python

    Official

    Writes commit messages and pull request descriptions for the adk-python repository: Conventional Commits types and scopes, subject lines that say why a change was made, and the linked-issue and…

    22k GitHub stars~1.3k tokensUpdated today
    DevelopmentAuto-check passed

  • Git PR Flow

    wgzhao/Addax

    Standard branch, commit, and pull-request workflow for this repo.

    1.4k GitHub stars~216 tokensUpdated today
    DevelopmentAuto-check passed

More from UsefulSoftwareCo/executor

All 21 skills in this repo

  • Effect Client Wrapper

    UsefulSoftwareCo/executor

    Pattern for wrapping third-party SDK clients (Stripe, Resend, AWS, etc.) with Effect.

    4.1k GitHub starsUsed in 1 repo~1.4k tokens
    Auto-check passed

  • CLI Release

    UsefulSoftwareCo/executor

    Runbook for releasing the executor CLI package (stable and beta).

    4.1k GitHub stars~2k tokensUpdated today
    Auto-check passed

  • Effect Atom Optimistic Updates

    UsefulSoftwareCo/executor

    Pattern for implementing optimistic UI updates with effect-atom in this codebase.

    4.1k GitHub stars~2.5k tokensUpdated today
    Auto-check passed

  • Effect HTTP Testing

    UsefulSoftwareCo/executor

    Testing Effect HttpApi services end-to-end. An agent skill from UsefulSoftwareCo/executor.

    4.1k GitHub stars~1.6k tokensUpdated today
    Auto-check passed

  • Emulate

    UsefulSoftwareCo/executor

    Use the @executor-js/emulate service emulators (GitHub, Google, Stripe, Resend, WorkOS, …) to test integrations for real — full OpenAPI specs, working OAuth flows, mintable credentials, and a…

    4.1k GitHub stars~2.2k tokensUpdated today
    Auto-check: notes

  • Prod Telemetry

    UsefulSoftwareCo/executor

    Query Executor's production telemetry — Axiom traces (executor-cloud dataset), prod Postgres via PlanetScale, PostHog product analytics — through the Executor MCP.

    4.1k GitHub stars~1.9k tokensUpdated today
    Auto-check passed

Works with

Categories

Questions about Graphite

What does Graphite do?

Manage Git branches and PRs using Graphite CLI (gt) instead of raw git commands. Graphite is an agent skill from UsefulSoftwareCo/executor. Manage Git branches and PRs using Graphite CLI (gt) instead of raw git commands.

When should I use Graphite?

Graphite fits situations like: committing code changes; amending commits; creating branches; submitting pull requests.

How do I install Graphite in Claude Code?

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

How do I install Graphite in Codex?

Run `npx skills add UsefulSoftwareCo/executor --skill graphite -a codex`. Or copy the skill folder (.skills/graphite in UsefulSoftwareCo/executor) into .agents/skills/graphite in your project. Codex loads it when a task matches its description.

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

What does Graphite need to run?

Going by SKILL.md and its folder, Graphite needs the command-line tools its instructions call (git).

Does Graphite access the network?

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

Is Graphite 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 Graphite use?

Graphite 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 Graphite use?

About 2.6k tokens (SKILL.md is roughly 10k 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 Graphite?

Skills that share tags, products or a category with Graphite: Git Workflow and Versioning (addyosmani/agent-skills, 102k stars), React Router Pull Request Creator (remix-run/react-router, 57k stars), Emoji Commit Conventions (baptisteArno/typebot.io, 11k stars) and Draft Pull Request Creator (wordpress-mobile/WordPress-Android, 3.2k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Graphite?

UsefulSoftwareCo (a GitHub organization) maintains it in UsefulSoftwareCo/executor, which has 4,085 GitHub stars. The repository holds 21 skills in this directory. The repository was last updated on October 7, 2026.

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