CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

git-stack

Stack an existing or new git branch on top of another branch, restacking it in a git worktree when needed, then align the GitHub PR bases and stack metadata with `gh stack`. Use when invoked as `$git-stack` or when the user asks to stack or restack a branch or PR onto another branch.

Quality

92%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

88%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

An excellent operational skill: fully executable bash at every step, careful safety rails (backup, rollback, force-with-lease, verification gates) around a destructive workflow, and no conceptual padding. The remaining gains are trimming a few code-restating glosses and moving the conflict-resolution policy and worktree conventions into reference files.

Suggestions

Delete the step-5 parenthetical that restates the `rebase --onto` code block verbatim — the code block alone is unambiguous.

Move the step-5 conflict-resolution rules (rerere, --ours/--theirs by change class, rollback) into a one-level-deep reference file (e.g. references/conflicts.md) to reduce the always-loaded body while keeping the details one hop away.

Extract the worktree path convention (`$HOME/.worktrees/${path_key}/${subject}`) and remote/trunk resolution into a short reference file, since they are reusable boilerplate rather than stacking-specific guidance.

DimensionReasoningScore

Conciseness

The body is dense and assumes git competence, explaining only non-obvious rationale ("`--no-track` is mandatory here: a branch cut from a remote base must not inherit the base's upstream", "Never hard-code `origin`"), and there is no conceptual padding. Not 5: a few glosses restate what the adjacent code already shows, e.g. the step-5 parenthetical "(equivalent to `git rebase --onto <base_ref> <merge-base> <subject>`, run with `-C \"$work_dir\"`.)" duplicates the code block immediately above it.

4 / 5

Actionability

Every step ships copy-paste-ready bash with variables defined (remote/trunk resolution, worktree selection, `git rebase --onto`, `git push --force-with-lease`, `gh pr edit --base`, `gh stack link`), and edge cases like multiple remotes, missing PRs, and merged PRs each get concrete handling. Fully executable guidance covering the common cases.

5 / 5

Workflow Clarity

A 12-step sequence for a destructive operation (rebase + force-push) with explicit validation checkpoints: dirty-tree check before rewriting (step 3), a pre-rebase backup with rollback (`reset --hard "${subject}.bak"`), a conflict feedback loop with per-conflict-class resolution rules and `rebase --continue` (step 5), tracking-line verification that must pass before continuing ("must show `[${remote}/${subject}]`; fix it before continuing"), and a final report checklist (step 12). This matches the feedback-loops and explicit-validation anchor.

5 / 5

Progressive Disclosure

Good structure: a numbered workflow with per-step code blocks, a Never section, and inline signposts to related skills (`pr-create`, `pr-style`, `using-git-worktrees`, git-rebase's conflict handler); the single-procedure content is mostly appropriately placed inline. Not 5: at ~185 lines with no bundle files, self-contained sections like the step-5 conflict-resolution policy or the worktree-path convention could be split into one-level-deep reference files to slim the always-loaded body.

4 / 5

Total

18

/

20

Passed

Description

92%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description: concrete, third-person, and comprehensive about what the skill does, with an explicit and natural trigger clause. The only weakness is minor missing synonym coverage in the trigger terms.

DimensionReasoningScore

Specificity

"Stack an existing or new git branch on top of another branch, restacking it in a git worktree when needed, then align the GitHub PR bases and stack metadata with `gh stack`" lists four concrete actions (stack, worktree restack, PR-base alignment, gh stack metadata alignment) covering the skill's full capability set. Not 4: no meaningful capability is left unstated, so coverage is comprehensive rather than having minor gaps.

5 / 5

Completeness

Explicitly answers both what ("Stack ... restacking it in a git worktree ... align the GitHub PR bases and stack metadata with `gh stack`") and when ("Use when invoked as `$git-stack` or when the user asks to stack or restack a branch or PR onto another branch") with concrete trigger phrases. Not 4: the when-clause is fully explicit and specific rather than merely present.

5 / 5

Trigger Term Quality

"Use when invoked as `$git-stack` or when the user asks to stack or restack a branch or PR onto another branch" includes the natural phrases users of stacked PRs actually say (stack, restack, onto another branch, PR). Not 5: a few natural variations like "stacked PRs", "chain PRs", or "change a PR's base" are absent; not 3 because the core vocabulary users would naturally use is present and specific.

4 / 5

Distinctiveness Conflict Risk

The stacked-PR/`gh stack`/worktree niche is clearly claimed and the triggers ("stack or restack a branch or PR onto another branch") are domain-specific vocabulary unlikely to fire for unrelated skills. Not 4: it does not meaningfully overlap with generic rebase, worktree, or PR-creation skills because the trigger terms are distinct to stacking.

5 / 5

Total

19

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

phatblat/dotfiles

Path

.agents/skills/git-stack/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.