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

100%

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.

The SKILL.md body is a lean, high-density operational guide: executable commands with non-interactive flags throughout, clearly sequenced workflows with confirm/recovery checkpoints, and a disciplined split into three trigger-indexed reference files. It teaches only what is non-obvious about this specific tool and omits everything Claude already knows.

DimensionReasoningScore

Conciseness

Every section carries non-obvious, tool-specific knowledge Claude cannot already have (TTY/PTY branching, stack orientation semantics, the exit-code table, worktree catalog behavior), with no padding and no explanation of general git/GitHub concepts. Even dense passages like "parse only successful path-mode stdout, never status messages" earn their tokens, matching the level-5 'every token earns its place' anchor rather than level 4's 'minor instances of over-explanation'.

5 / 5

Actionability

The body is dominated by copy-paste-ready invocations with the exact safe flags: "gh stack submit --auto", "gh stack merge 42 --yes --squash", "gh stack rebase --upstack", a complete core loop, and an 'Always run / Never run bare' table with reasons. This exceeds the level-4 anchor (concrete commands with minor gaps) and matches level 5: specific examples cover the common cases, with only inherent placeholders like "git add ..." whose content is user work.

5 / 5

Workflow Clarity

Sequences are explicit and validated: the core loop ends with "gh stack view --json # confirm", the edit workflow validates ownership first ("Run gh stack view --json; if ownership is unclear, inspect git log --all -- <path>"), and the exit-code table plus the Exit 3 recovery procedure (resolve → git add → rebase --continue, or --abort) form an explicit feedback loop and error-recovery checklist. This matches the level-5 anchor; level 4 ('minor validation gaps') would understate the recovery coverage.

5 / 5

Progressive Disclosure

The body stays a focused overview and defers detail to three real, verified, one-level-deep reference files, each given an explicit trigger in 'More detail' ("read before creating a stack", "read when a command fails unexpectedly", "read on a rebase conflict"), plus "Open the reference whose trigger matches the task; no need to preload all three." This is the level-5 anchor (clear overview, well-signaled one-level-deep references) exactly; no nested references exist in the bundle.

5 / 5

Total

20

/

20

Passed

Description

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

The description is a model example: third-person voice, a concrete two-part capability statement, an explicit 'Use for' clause enumerating operations, and natural trigger synonyms including the literal command name. It answers both 'what' and 'when' unambiguously with no padding or over-claims.

DimensionReasoningScore

Specificity

"Manages stacked PRs and splits multi-part work into reviewable branches" plus the enumerated operations "stack creation, viewing, edits, push, submit, sync, rebase, merge, or checkout" list nine concrete, tool-verifiable actions covering the CLI's full surface. This matches the level-5 anchor (multiple specific concrete actions, comprehensive coverage) rather than level 4, which reserves minor gaps in coverage.

5 / 5

Completeness

The 'what' is explicit ("Manages stacked PRs and splits multi-part work into reviewable branches with gh-stack") and the 'when' is an explicit "Use for ... whenever a user mentions ... or when a stack is checked out" clause with concrete trigger phrases. Both halves are clearly and explicitly answered, matching the level-5 anchor exactly.

5 / 5

Trigger Term Quality

"a stack, branch layers, dependent PRs, or gh stack" and "split or isolate work for review" cover the natural synonyms a user would actually say, including the literal command name. Coverage is comprehensive for this domain (there is no file extension to include), so it fits the level-5 anchor better than level 4's 'a few natural terms missing'.

5 / 5

Distinctiveness Conflict Risk

The description is anchored to a specific niche tool (gh-stack, stacked/dependent PRs) with distinct triggers like "branch layers" and "gh stack" that no generic git-branching skill would claim, giving minimal conflict risk — the level-5 anchor. It is well above level 4's 'minor overlap risk with closely related skills'.

5 / 5

Total

20

/

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

Arize-ai/phoenix

Path

.agents/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.