CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

rebase-stack

Rebases a gh-stack-tracked chain of stacked branches onto its updated base, guides conflict resolution, validates the stack, and pushes every branch with fork-aware PR creation. Requires the gh-stack extension and an existing tracked multi-branch stack; refuses to run otherwise. Do NOT use it to rebase a single branch onto main — plain git rebase does that. Activated by commands: /start, /continue, /validate, /push.

Quality

77%

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

Fix and improve this skill with Tessl

tessl review fix ./rebase-stack/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

53%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 body is a model of conciseness and the description does its job, but the skill is broken as a bundle: all six referenced markdown files are missing and the eight substantive shell scripts that do exist are never mentioned. As written, an agent following it hits a dead end at the first instruction.

Suggestions

Fix the reference targets: either add `skills/controller.md`, `commands/start.md`, `commands/continue.md`, `commands/validate.md`, `commands/push.md`, and `guidelines.md` to the bundle, or correct the paths in SKILL.md to point at the files that actually exist.

Reference the real bundle assets from the body — e.g. note that `scripts/preflight.sh` is the hard gate (exit 2 = not in a stack, no fallback), that `scripts/stack-status.sh` reports stale/diverged/PR-less layers, and that `scripts/push-guard.sh` guards the push phase — so the existing scripts are discoverable.

Since this is a batch, hard-to-reverse workflow (rebasing and force-pushing every branch), state the validation loop explicitly in the body or in a present file: validate the trunk-adjacent branch (scripts/validate-branches.sh) before push, and how to recover via `/continue` when a conflict stops the rebase.

DimensionReasoningScore

Conciseness

The ~15-line body is lean and assumes competence: a routing table, the gating condition ("Refuses to run unless `gh stack` is installed and `gh stack view --json` exits 0"), and a pointer to scope rules. It explains nothing Claude already knows and every sentence carries new, load-bearing information. Fits the 'lean and efficient; every token earns its place' anchor exactly.

5 / 5

Actionability

The body's instructions are "Read `skills/controller.md` and follow it" plus a command table mapping to `commands/*.md` — but none of those files exist in the bundle (only `scripts/` with 8 shell scripts exists, none referenced from the body). The one executable check written out (`gh stack view --json` exits 0) is concrete, but the specific steps for every phase live in files that are missing, so executing this skill as written fails immediately. This matches 'minimal concrete guidance; high-level hints but missing the specific steps to execute' better than the level-3 anchor, since the missing files are the guidance itself rather than a detail gap.

2 / 5

Workflow Clarity

The four phases (start, continue, validate, push) are sequenced in the table and a gating preflight is stated, which is a real sequence. But the actual checkpoints and recovery loops are delegated to files that don't exist, so as written the validation checkpoints are implicit rather than explicit — matching 'steps listed but validation gaps; checkpoints missing or implicit'. This is also a batch/destructive workflow (rebase + push of every branch), and the body itself contains no validate→fix→retry loop, which caps it at 3.

3 / 5

Progressive Disclosure

Scored against the actual bundle: every referenced path is broken — `skills/controller.md`, `commands/start.md`, `commands/continue.md`, `commands/validate.md`, `commands/push.md`, and `guidelines.md` do not exist anywhere in the bundle, while the 8 real files in `scripts/` (preflight, stack-status, validate-branches, push-guard, snapshot, etc.) are never referenced from the body. The one-level routing idea is right and the table is well-signaled, but navigation leads nowhere and the existing bundle content is undiscoverable, which fits the level-2 anchor (references buried/unusable) rather than the level-3 'references present but not clearly signaled'.

2 / 5

Total

12

/

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, comprehensive capability list with explicit command-based activation, prerequisites, refusal conditions, and an explicit negative trigger that prevents confusion with plain git rebase. The only soft spot is trigger-term breadth — a few natural user phrasings ("stacked PRs", "update my stack") are absent.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — "Rebases a gh-stack-tracked chain of stacked branches onto its updated base, guides conflict resolution, validates the stack, and pushes every branch with fork-aware PR creation" — covering the full workflow comprehensively with no vague filler. It matches the anchor for multiple specific concrete actions with comprehensive coverage; nothing is generic or abstract, so the level-4 anchor ('minor gaps in coverage') is too low.

5 / 5

Completeness

What is answered concretely (rebase the stack, resolve conflicts, validate, push, open PRs) and when is answered with equivalent explicit trigger guidance: "Activated by commands: /start, /continue, /validate, /push" plus prerequisites ("Requires the gh-stack extension and an existing tracked multi-branch stack; refuses to run otherwise") and an explicit negative trigger ("Do NOT use it to rebase a single branch onto main"). This is not the level-4 case of a weakly implied 'when' — the trigger guidance is explicit, concrete, and even states when not to use it.

5 / 5

Trigger Term Quality

Natural terms a user of this tool would say are present: "rebase", "stacked branches", "stack", "conflict resolution", "pushes", "PR creation". A few natural variations are missing (e.g. "stacked PRs", "update my branches", "gh stack" as a user phrase), so it fits the 'good keyword coverage; a few natural terms missing' anchor rather than the comprehensive-synonyms anchor at 5.

4 / 5

Distinctiveness Conflict Risk

It carves out a clear niche (gh-stack-tracked multi-branch stacks) and actively de-conflicts with the nearest overlapping capability: "Do NOT use it to rebase a single branch onto main — plain git rebase does that", plus a hard refusal condition. Minimal conflict risk with any other skill; the level-4 anchor ('minor overlap risk') understates the explicit negative scoping.

5 / 5

Total

19

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

flightctl/ai-workflows

Path

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