CtrlK
BlogDocsLog inGet started
Tessl Logo

diff-review

Render the patch-edit run's accumulated changes as a reviewable diff, surface it through a GenUI choice surface, and persist the user's accept / reject decision into the artifact manifest.

66

Quality

80%

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 ./plugins/_official/atoms/diff-review/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

100%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The content is concise, highly actionable, and well-structured with an explicit convergence checkpoint, scoring at the top of every dimension for a self-contained instruction-style skill.

DimensionReasoningScore

Conciseness

The body is lean and assumes Claude's competence — it never explains what a diff, git restore, or GenUI is, and every section earns its place; this matches the 'lean and efficient; every token earns its place' anchor rather than the padded score-2 case.

3 / 3

Actionability

It gives concrete, executable guidance — exact output paths, the decision.json schema, 'git restore' for rollback, and named implementation files (diff-review.ts, diff-review-genui-bridge.ts); for an instruction/contract skill the rubric does not penalize absence of code when guidance is this specific, so it reaches the fully-actionable anchor.

3 / 3

Workflow Clarity

The sequence (render diff → surface choice → capture decision → persist or rollback) is clear and anchored by an explicit completion checkpoint ('completes when decision.json has a non-empty decision'); this is a review/capture atom rather than a destructive batch op, so the feedback-loop cap does not apply, and it sits at the clear-sequence-with-checkpoints anchor.

3 / 3

Progressive Disclosure

Under 50 lines, self-contained with well-organized sections (Inputs, Output, Convergence, Anti-patterns, Status) and no external bundle files; the simple-skill scoring note allows a score of 3 with just well-organized sections, which this satisfies.

3 / 3

Total

12

/

12

Passed

Description

60%

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 states concrete capabilities clearly but relies on internal jargon and omits any 'Use when...' trigger guidance, capping completeness and trigger quality at 2. Adding a plain-language trigger clause would lift the two lowest dimensions.

Suggestions

Add a 'Use when...' clause stating when to invoke the atom (e.g., 'Use when a patch-edit run needs human sign-off on its accumulated changes or the user asks to review/accept/reject a generated diff').

Replace or gloss project jargon ('patch-edit run', 'GenUI choice surface', 'artifact manifest') with terms a user would naturally say, such as 'review the changes', 'accept or reject', and 'record the decision'.

Include natural variations like 'diff', 'code review', 'accept/reject changes', and 'patch review' to broaden trigger-term coverage.

DimensionReasoningScore

Specificity

Lists three concrete actions — 'Render the patch-edit run's accumulated changes as a reviewable diff', 'surface it through a GenUI choice surface', and 'persist the user's accept / reject decision into the artifact manifest' — matching the multiple-specific-actions anchor at score 3 rather than the partial domain-only score 2.

3 / 3

Completeness

The 'what' is explicit and strong, but the 'when' is entirely missing — there is no 'Use when...' clause or equivalent trigger guidance, which per the judging guidelines caps completeness at 2; it is not the score-1 case that lacks both, and not the score-3 case that states an explicit trigger.

2 / 3

Trigger Term Quality

It has real keywords ('diff', 'accept / reject decision') but leans on project jargon ('patch-edit run', 'GenUI choice surface', 'artifact manifest') and omits common natural variations a user would say; not the no-natural-keywords score 1, but short of the broad natural-term coverage at score 3.

2 / 3

Distinctiveness Conflict Risk

The niche (reviewable diff surfaced via GenUI choice with manifest persistence) is reasonably distinct and unlikely to trigger for the wrong skill, but the triggers are not framed in a way that sharply separates it from sibling review atoms, so it sits at 'somewhat specific but could still overlap' rather than the clearly-distinct score 3.

2 / 3

Total

9

/

12

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.

Validation15 / 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
nexu-io/open-design
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.