CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

gh-stack

Manages stacked PRs and splits multi-part work into reviewable branches with gh-stack. Use for stack creation, viewing, edits, push, submit, sync, rebase, merge, or checkout; when asked to split or isolate work for review; whenever a user mentions a stack, branch layers, dependent PRs, or gh stack; or when a stack is checked out.

Quality

98%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

100%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.

Exemplary skill body: terse, non-obvious operational detail delivered as executable commands, tables, and schemas, with error-recovery feedback loops for every risky operation. Detail is correctly offloaded to three well-triggered, one-level-deep reference files that all exist.

DimensionReasoningScore

Conciseness

The body is dense with non-obvious, tool-specific facts only (PTY/TUI blocking, "`gh stack help <command>` does not work", exit-code semantics, stale `base` SHA meaning) and explains nothing Claude already knows. No trimmable over-explanation was found, so it fits the lean/every-token-earns-its-place anchor rather than the minor-trimming anchor.

5 / 5

Actionability

Copy-paste-ready commands throughout: the core loop, the edit flow (`gh stack down` ... `rebase --upstack` ... `push`), `sync --prune`, and `merge 42 --yes --squash`, plus an always-run/never-run flag table, a JSON output schema, and a recovery column for every exit code. Fully executable and covering the common cases.

5 / 5

Workflow Clarity

Multi-step flows are explicitly sequenced with validation checkpoints ("`gh stack view --json` # confirm", "Check the exit status before changing directories", "branch on exit codes") and genuine feedback loops for error recovery (Exit 3 resolve → `git add` → `rebase --continue`/`--abort`, sync-divergence abort, lock retry). Destructive and batch operations all carry validation or recovery, so the workflow-clarity cap does not apply.

5 / 5

Progressive Disclosure

The body stays an overview and delegates detail to three real, one-level-deep reference files (verified on disk: stack-design.md, commands.md, troubleshooting.md), each given an explicit trigger ("read before creating a stack", "read when a command fails unexpectedly", "read on a rebase conflict") plus "no need to preload all three". Reference cross-links are sibling-level only, matching the clear-overview anchor.

5 / 5

Total

20

/

20

Passed

Description

96%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 model description: third-person voice, explicit what-and-when structure, and concrete trigger phrases covering both natural synonyms and the literal CLI name. The only weakness is that the unqualified command-verb list (push, merge, checkout, etc.) in the trigger clause invites overlap with routine git/PR requests.

DimensionReasoningScore

Specificity

"Manages stacked PRs and splits multi-part work into reviewable branches" plus "stack creation, viewing, edits, push, submit, sync, rebase, merge, or checkout" names nine concrete operations covering the full stack lifecycle, matching the comprehensive-coverage anchor rather than the minor-gaps anchor.

5 / 5

Completeness

It explicitly answers "what" ("Manages stacked PRs and splits multi-part work into reviewable branches with gh-stack") and "when" ("Use for ... whenever a user mentions a stack, branch layers, dependent PRs, or gh stack; or when a stack is checked out") with concrete trigger phrases, matching the anchor-5 example.

5 / 5

Trigger Term Quality

Natural trigger terms include "a stack, branch layers, dependent PRs, or gh stack" and "split or isolate work for review", covering colloquial synonyms plus the exact CLI string a user would type. It is not a 4 because both the natural phrasings and the literal tool invocation are present.

5 / 5

Distinctiveness Conflict Risk

The niche is clear ("stacked PRs", "dependent PRs", "gh stack"), but the bare verb list "push, submit, sync, rebase, merge, or checkout" in the Use-for clause could fire on ordinary git/PR requests, giving minor overlap risk with generic git-workflow guidance. It is not 5 because of that unscoped verb list, and not 3 because the domain triggers are strongly specific.

4 / 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

MesilimLLC/Trackdub

Path

.claude/skills/gh-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.