CtrlK
BlogDocsLog inGet started
Tessl Logo

gitbutler

github.com/gitbutlerapp/gitbutler

SkillAddedReview
but

crates/but/skill/SKILL.md

Commit, push, branch, and manage version control with GitButler. Use for commits, selective dirty-file or hunk commits, branches, diffs, PRs, history edits, squashes, amends, undo, merge, fetching, pulling and syncing a branch with its remote, apply, unapply, and linked worktrees. For selected dirty files or hunks, inspect with `but diff`; use compact `but status` for commit order, branch/stack placement, or conflict overview; use `but status -fv` when file IDs or per-commit file details matter. Replaces git write commands, including fetch and pull. Applies in every checkout of the repository, even when a plain branch is checked out, including linked worktrees such as `.claude/worktrees/*`, and to git writes made while testing or cleaning up (stash, checkout -- <file>, restore, reset).

74

but-agentlog

crates/but-agentlog/skill/SKILL.md

Use for prompts like "get context for branch", "catch up on this branch", "recover branch context", or "what prior agent work happened here". Skim prior agent work from `but agentlog` captures for a GitButler branch, review / pull request / merge request, or change. Prefer this over generic git branch/diff inspection when the user asks for context, history, prior work, or branch catch-up.

71

but-performance-tests

.agents/skills/but-performance-tests/SKILL.md

Use when creating, changing, running, or debugging shell-based `but` CLI performance scenarios under `crates/but/tests/performance`, including Hyperfine runs, fixture setup, setup-to-test state, and output inspection.

72

cli-commands

.agents/skills/cli-commands/SKILL.md

Use when adding or modifying CLI command (`but` commands) under `crates/but/src`.

57

design-tokens

.agents/skills/design-tokens/SKILL.md

Use when pulling design tokens from Figma into `packages/but-ui`, regenerating `tokens.css`, or reviewing a token change: sync/export/update tokens, a Figma variable was added, renamed or changed, or `pnpm check` says tokens.css is stale. Not for using tokens in components; that is the gitbutler-ui skill.

76

gitbutler-ui

packages/ui-react/skill/SKILL.md

Use when changing what users see in an app built on `@gitbutler/ui-react`, such as the but.dev web app: adding or restyling a component, modal, form, list, empty state or toast, or writing the words on screen. Not for logic, data or backend work, even inside a UI file.

73

gitbutler-ui

packages/but-ui-react/skill/SKILL.md

Use when changing what users see in an app built on `@gitbutler/but-ui-react`, such as the but.dev web app: adding or restyling a component, modal, form, list, empty state or toast, or writing the words on screen. Not for logic, data or backend work, even inside a UI file.

77

gpui-screenshots

.agents/skills/gpui-screenshots/SKILL.md

Use whenever you need to see, click through or screenshot the GPUI client (crates/but-gpui), to check a UI change works, reproduce a UI bug, or show what a change looks like. Drives the app from a script in a window that never shows on the user's screen, against throwaway app data. Never start the app with `cargo run` or the plain binary to look at it.

76

tui-tests

.agents/skills/tui-tests/SKILL.md

Use when adding or modifying tests for one of GitButler's Ratatui TUIs

71