CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

change-review

Use when reviewing a set of changes before they merge in a Repowise-indexed repository, a PR, a branch diff, or the working-tree changes you just made. Activates for "review this PR", "is this safe to merge", "what is the blast radius of these changes", or "did I miss anything".

Quality

77%

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

Fix and improve this skill with Tessl

tessl review fix ./plugins/codex/skills/change-review/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

81%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 strong, highly actionable workflow: concrete parameterized MCP invocations and CLI commands for every entry path (PR, branch, working tree), an explicitly sequenced review process with decision checkpoints, and a genuine error-recovery fallback. Its only real weakness is token efficiency — the opening bullets duplicate the detailed sections, the terminal-CLI equivalent is repeated, and dense field-level API detail is inlined rather than offloaded to a reference file.

DimensionReasoningScore

Conciseness

Every token is Repowise-specific with no explanations of concepts Claude already knows, but it could be tightened: the two-bullet intro duplicates the "Score the whole change first" section, the `repowise risk <revspec>` CLI equivalent is stated twice nearly verbatim ("The `repowise risk <revspec>` CLI is the identical scorer" and "The equivalent from a terminal is `repowise risk <revspec>`"), and the `tests_to_run` bullet inlines dense field-by-field API detail. Mostly efficient with some redundancy — anchor 3.

3 / 5

Actionability

Fully concrete invocations with parameters cover the common cases: `get_change_risk(revspec="main..HEAD")`, `get_risk(targets=<changed files>, changed_files=<same changed files>)`, `get_why(query="<file>")`, `get_health(targets=..., include=["biomarkers"])`, plus terminal paths `gh pr diff <number>`, `git diff --name-only main...HEAD`, and `repowise impacted-tests <revspec>` with `--format list | xargs pytest`. Placeholders like `<changed files>` are inherently variable and appropriately used.

5 / 5

Workflow Clarity

The headers impose an explicit sequence ("Score the whole change first" → "Then drill into the per-file directive" → "Then go deeper where it matters"), with decision checkpoints ("read `directive` first", "Check `tests_run_all` first", a `warning` field or `unknown` status means an all-zero score is not a clean bill of health) and an error-recovery feedback path (if `get_risk` errors, review from the raw diff and note Repowise was unavailable, suggesting `/prompts:repowise-init`). This is read-only analysis, so the destructive/batch validation cap does not apply.

5 / 5

Progressive Disclosure

No bundle files exist, and the ~115-line body is well-organized under clear section headers with a logical overview-to-detail flow. Not 5 because all content is inlined — the field-level semantics of `tests_to_run`, `tests_run_all`, `tests_to_run_basis`, and `impacted_tests` read like API-reference material that could live in a one-level-deep reference file; not 3 because structure and placement are otherwise good with nothing buried.

4 / 5

Total

17

/

20

Passed

Description

61%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 excels at explicit trigger guidance — the "Use when" clause and four quoted activation phrases leave no ambiguity about when to invoke it — and it is concise. Its weaknesses are a generic "what" ("reviewing a set of changes" names the task but not the skill's concrete capabilities), a second-person slip ("the working-tree changes you just made"), and trigger phrases broad enough to collide with generic code-review skills despite the Repowise scoping.

Suggestions

State concrete third-person capabilities up front, e.g. "Scores pre-merge change risk, identifies blast radius and missing co-changes, and selects impacted tests using Repowise" instead of the generic "reviewing a set of changes".

Remove second-person voice: replace "the working-tree changes you just made" with "uncommitted working-tree changes".

Lead the trigger list with Repowise-specific terms (e.g. "Repowise change risk", "pre-merge risk review", "score this diff") so generic phrases like "review this PR" don't cause it to fire where a plain code-review skill is intended.

DimensionReasoningScore

Specificity

The description names the domain ("reviewing a set of changes before they merge") and enumerates target contexts ("a PR, a branch diff, or the working-tree changes"), but the only action stated is the generic "reviewing" — concrete capabilities like risk scoring or blast-radius analysis are only hinted at via a quoted user phrase. Per the guidelines, the second-person clause "the working-tree changes you just made" reduces the score by 1 from a base of 3.

2 / 5

Completeness

Both parts are present: the "what" ("reviewing a set of changes before they merge") and an exceptionally explicit "when" ("Use when..." plus "Activates for" four concrete trigger phrases). Not 5 because the "what" stays generic — it never states what the skill actually does (risk scoring, impacted-test selection, blast-radius analysis) the way the anchor-5 example lists concrete actions.

4 / 5

Trigger Term Quality

Quoted phrases "review this PR", "is this safe to merge", "what is the blast radius of these changes", and "did I miss anything" are natural things a user would say, alongside "PR", "branch diff", and "working-tree". Not 5 because common variations like "code review", "review my changes", or "review the diff" are missing; not 3 because coverage goes well beyond a couple of generic keywords.

4 / 5

Distinctiveness Conflict Risk

The "Repowise-indexed repository" scoping and "blast radius" phrasing give it a niche, but the triggers "review this PR", "is this safe to merge", and "did I miss anything" would equally fire for any generic code-review skill, creating real overlap risk. Not 4 because that overlap is more than minor; not 2 because the Repowise tie is genuinely distinguishing.

3 / 5

Total

13

/

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

repowise-dev/repowise

Path

plugins/codex/skills/change-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.