CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

review

Pre-landing PR review. Analyzes diff against the base branch for SQL safety, LLM trust boundary violations, conditional side effects, and other structural issues. Use when asked to "review this PR", "code review", "pre-landing review", or "check my diff". Proactively suggest when the user is about to merge or land code changes.

Quality

81%

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

63%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 review workflow itself is exceptionally actionable — exact commands, classification schemes, output templates, and verification checkpoints throughout. But the file is bloated by hundreds of lines of gstack framework boilerplate (persona, telemetry prompting, contributor mode) that is irrelevant to the review task, and the detailed checklists it depends on are not actually shipped in the bundle.

Suggestions

Move the framework-wide policy sections (Voice, AskUserQuestion Format, Completeness Principle, Contributor Mode, telemetry flows) into a shared gstack reference file loaded once, cutting ~325 lines of off-task content from this skill's context load.

Ship checklist.md, greptile-triage.md, and design-checklist.md inside the skill's own references/ directory (or bundle the key rules inline) so the skill is self-contained and the references resolve reliably.

Clean up the step structure: remove the duplicated 'Step 4.5' heading and renumber the awkward decimal steps (4.5, 4.75, 5.5, 5.6, 5.8) into a coherent sequence so the workflow is easier to follow.

DimensionReasoningScore

Conciseness

The body is ~950 lines, and roughly the first 325 (the gstack "Voice" persona, AskUserQuestion format, Completeness Principle, telemetry/lake-intro prompting flows, Contributor Mode) are framework policy unrelated to reviewing a PR; telemetry logging is even specified twice (preamble and "run last"), and the "Step 4.5" heading appears duplicated back-to-back. This matches 'noticeably verbose; several unnecessary explanations or padded sections' — it is not a 1 because the core review steps are dense and command-driven rather than explaining concepts Claude already knows, and not a 3 because the volume of off-task padding goes well beyond 'could be tightened'.

2 / 5

Actionability

Guidance is fully executable: exact commands ("git diff origin/<base>", "gh pr view --json baseRefName -q .baseRefName", glab and git-native fallback chains), explicit classification schemes (DONE/PARTIAL/NOT DONE/CHANGED), concrete output templates, and precise substitution tables (TIMESTAMP, STATUS, N, COMMIT). Copy-paste-ready commands with fallbacks cover the common cases, matching the top anchor.

5 / 5

Workflow Clarity

Steps are clearly sequenced (Step 0 through 5.8) with explicit stop/skip conditions, a verification-of-claims checkpoint ("Never say 'likely handled' or 'probably tested'"), a mandatory regression rule, and an escalation protocol — most checkpoints are present. It falls short of anchor 5 because the decimal step numbering (4.5, 4.75, 5.5, 5.6, 5.8 with no 5.7), the duplicated Step 4.5 heading, and interleaving of framework policy make the sequence harder to follow than a clean validate/fix/retry loop.

4 / 5

Progressive Disclosure

References to checklist.md, greptile-triage.md, and design-checklist.md are one level deep and clearly signaled, but none of them ship in this skill's bundle (no references/, scripts/, or assets/ exist — they resolve to an external gstack install), and ~40% of the body is framework-wide policy that belongs in shared reference files. This matches 'some structure but could be better organized; content that should be separate is inline' — not anchor 2 because real structure and explicit references exist, not anchor 4 because the inline policy content is far more than a minor organization gap.

3 / 5

Total

14

/

20

Passed

Description

91%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 strong: third-person, concrete about what it checks, with explicit and natural 'Use when...' trigger phrases. Its only weaknesses are the vague "other structural issues" hedge and the somewhat generic "code review" trigger that could collide with a general review skill.

DimensionReasoningScore

Specificity

"Analyzes diff against the base branch for SQL safety, LLM trust boundary violations, conditional side effects, and other structural issues" lists several concrete, specific review actions. It stops short of anchor 5 because "and other structural issues" is a hedge and real capabilities (scope-drift detection, test-coverage audit, fix-first auto-fixing) are not named, leaving minor coverage gaps.

4 / 5

Completeness

It explicitly answers both what ("Analyzes diff against the base branch for SQL safety, LLM trust boundary violations, conditional side effects...") and when ("Use when asked to..." with concrete quoted trigger phrases). This matches the anchor for clearly and explicitly answering both with concrete triggers; anchor 4's 'when could be more explicit' does not apply.

5 / 5

Trigger Term Quality

"Use when asked to 'review this PR', 'code review', 'pre-landing review', or 'check my diff'" plus "Proactively suggest when the user is about to merge or land code changes" covers the natural phrasings a user would actually say, including the proactive trigger. No common variations are missing within this domain, so it matches the comprehensive anchor rather than the 'a few natural terms missing' anchor.

5 / 5

Distinctiveness Conflict Risk

"Pre-landing PR review" carves a clear niche with distinct triggers, but the generic trigger "code review" overlaps with closely related general code-review skills, matching the 'mostly distinct; minor overlap risk' anchor. It is not anchor 5 because the conflict risk is more than minimal, and not anchor 3 because the pre-landing/diff-against-base framing is far more specific than 'somewhat specific'.

4 / 5

Total

18

/

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

skill_md_line_count

SKILL.md is long (967 lines); consider splitting into references/ and linking

Warning

Total

15

/

16

Passed

Repository

valeriibeck-star/claude-skills

Path

skills/gstack/.agents/skills/gstack-review/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.