CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

feature-review

Reviews a PR, commit, range, or branch as a feature first and code second, in a local HTML page whose comments post back to the PR as one GitHub review. Use when the user asks to review a PR or commit, review the feature or shape of a change, or re-review a PR after new pushes: "review PR #123", "review this commit", "review the feature in PR #123", "re-review PR #123".

Quality

85%

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

86%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 exemplary instruction-skill body: copy-paste-ready commands for every input form, a tightly sequenced six-step workflow with explicit validation (self-check, guide validation, user-gated submission), and clean one-level progressive disclosure where each section defers detail to a real, verified reference file. The only notable deductions are minor redundancy (the tmp/ gitignore advice repeated, some page-UI mechanics inline) and the absence of an explicit failure-handling loop for the self-check.

DimensionReasoningScore

Conciseness

Dense, imperative prose with no concept explanations and no padding — every section instructs rather than describes. Not a 5 because of minor redundancy: the tmp/review gitignore advice appears in both Usage and Gotchas, the feature-overview format is described in both Workflow step 3 and 'The overview' section, and some page-UI mechanics ('Inside a recommendation the reviewer can also accept, edit or dismiss each comment') could live in references/page.md. Not a 3 because there is no unnecessary explanation of things Claude already knows.

4 / 5

Actionability

The 14-line usage block is copy-paste ready with concrete invocations for every input form (commit, range, PR, re-review, stdin), and the workflow names exact commands and paths: 'node $S/build-review.cjs <ref> --pr <N> --serve', 'node $S/pr-media.cjs --pr <N>', 'pbpaste | node $S/submit-review.cjs - [--dry-run]', '~/.claude/feature-review/preferences.md'. Specific examples cover the common cases, including edge handling like '-o path.html' for repos that don't gitignore tmp/.

5 / 5

Workflow Clarity

Six clearly sequenced steps (Gather → Load preferences and rules → Read the change → Build → Open → Report) with real checkpoints: the build 'runs the self-check and guide validation', step 6 reports the self-check, first-use preferences are handled explicitly, and 'The server exits after a successful submit, which notifies you'. Not a 5 because the body never says what to do when the self-check or guide validation fails — no explicit fix-and-retry loop — and some checkpoints (CI, media capture failure) are only implied. Not a 3 because validation is explicit and the destructive-adjacent action (submitting) is gated: 'Never submit on the user's behalf from the terminal unless they ask.'

4 / 5

Progressive Disclosure

The body is a true overview: each section summarizes its topic and defers full formats to a named, verified reference file ('Full format, guidance and examples: references/overview.md'; 'Format, the auto-review rules in full ... references/reading-guide.md'; 'recipes in references/gathering.md'), all 8 referenced files exist in the bundle, and the Files section lists every script and reference with a one-line description. References are one level deep — cross-links between overview.md and recommendations.md are peer links to files that contain their own content, not pointer chains.

5 / 5

Total

18

/

20

Passed

Description

80%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: third-person, concrete about what the skill does and produces, with an explicit 'Use when' clause carrying four quoted example phrases users would actually type. The main risk is trigger collision — 'review PR #123' and 'review this commit' are equally the natural phrasing for an ordinary code review, and the term 'code review' itself is absent.

DimensionReasoningScore

Specificity

Concrete actions are named — "Reviews a PR, commit, range, or branch", "in a local HTML page whose comments post back to the PR as one GitHub review" — covering the review targets, the mechanism, and the outcome. Not a 5 because the actions are woven into one long sentence rather than comprehensively enumerated (capture of screenshots, reading guides, and re-review mechanics appear only implicitly), and not a 3 because it goes well beyond naming a domain with 1-2 actions.

4 / 5

Completeness

Explicitly answers both: what it does ("Reviews a PR, commit, range, or branch as a feature first and code second, in a local HTML page whose comments post back to the PR as one GitHub review") and when to use it ("Use when the user asks to review a PR or commit, review the feature or shape of a change, or re-review a PR after new pushes") with concrete quoted trigger phrases — an exact match for the anchor-5 example pattern.

5 / 5

Trigger Term Quality

Quotes natural user phrases verbatim — "review PR #123", "review this commit", "review the feature in PR #123", "re-review PR #123" — plus prose triggers like "review the feature or shape of a change" and "re-review a PR after new pushes". Not a 5 because the most common natural phrasing for this domain, "code review" (and "diff"/"look at this PR" variants), is missing.

4 / 5

Distinctiveness Conflict Risk

The niche is differentiated by "as a feature first and code second, in a local HTML page" and "as one GitHub review", but the primary triggers — "review a PR or commit", "review PR #123", "review this commit" — are exactly what a user would say for a plain code review, so overlap with a closely related generic review skill is more than minor. Not a 4 because the core trigger collides head-on with the whole code-review domain; not a 2 because the feature-first/HTML-page/post-back mechanism and the "re-review" and "review the feature" triggers do set it apart.

3 / 5

Total

16

/

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

referenced_paths_exist

Referenced path issues: 1 deeper-than-1-level

Warning

Total

15

/

16

Passed

Repository

RoleModel/rolemodel-skills

Path

skills/feature-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.