CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

fix-review

Verify fix commits address audit findings without new bugs

Quality

56%

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/AI-Agents-Safe-Coding-Skills-claude/skills/fix-review/SKILL.md

The canonical home for this skill is fix-review in administrakt0r/AI-Agents-Safe-Coding-Skills

SKILL.md
Quality
Evals
Security

Quality

Content

42%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 well-structured and short, but it is boilerplate: every section restates the skill's purpose without adding executable review methodology. There is no concrete tooling, no criteria for judging a fix adequate, and no guidance on reporting outcomes, so a reader learns what the skill is for but not how to perform it.

Suggestions

Replace the duplicated Overview/When-to-Use/Instructions framing with one statement, and use the freed budget for concrete commands (e.g., how to enumerate fix commits with git rev-list/log, how to diff a fix against its parent).

Define explicit verification checkpoints: what evidence confirms a finding is resolved (test added, reproducer closed) and what to do when a fix is incomplete or introduces a regression.

Specify the output — e.g., a per-finding verdict (resolved / partially resolved / not resolved / new issue introduced) so the review has a concrete deliverable.

DimensionReasoningScore

Conciseness

The body is noticeably padded: the same purpose statement appears nearly verbatim in the Overview, "When to Use This Skill" intro, and "Instructions" ("Verify that fix commits properly address audit findings" / "Use this skill when you need to verify fix commits address audit findings" / "This skill helps verify that fix commits properly address audit findings"), and the Instructions numbered list restates the Review Process items. This matches 'Noticeably verbose; several unnecessary explanations or padded sections'. It is not 1 because there is no explanation of concepts Claude already knows, and not 3 because four sections of duplicated framing go beyond 'could be tightened'.

2 / 5

Actionability

Guidance is high-level hints only — "Compare the fix against the original audit finding", "Verify the fix addresses the root cause, not just symptoms", "Validate that tests cover the fixed scenario" — with no commands (e.g., git diff/rev-list invocation), no pass/fail criteria, no output format, matching 'Minimal concrete guidance; high-level hints but missing the specific steps to execute'. It is not 1 because the bullet lists do identify concrete review targets, and not 3 because nothing is executable or specific enough to act on directly.

2 / 5

Workflow Clarity

The Review Process lists a coherent 5-step sequence (compare, verify root cause, check side effects, validate tests, search for similar vulnerabilities), but checkpoints and outcomes are implicit — there is no guidance on what to do when a fix is incomplete or how to report results, matching 'Steps listed but validation gaps; sequence present but checkpoints missing or implicit'. It is not 4 because no explicit checkpoints exist, and not 2 because the sequence itself is ordered and each step is a discrete, meaningful action.

3 / 5

Progressive Disclosure

The body is under 50 lines, needs no external reference files (none exist in the bundle), and is organized into clearly labeled sections (Overview, When to Use, Instructions, Review Process, Best Practices, Resources) with a single outbound link to the source repository. Per the rubric's simple-skill guidance, this qualifies for 5 with just well-organized sections.

5 / 5

Total

12

/

20

Passed

Description

53%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 states a clear, specific purpose in the security-audit remediation niche, but reads as a capability statement rather than a trigger-rich description. Its main gaps are the complete absence of a 'Use when...' trigger clause and missing natural synonyms like remediation, patch, or regression.

Suggestions

Add an explicit trigger clause, e.g. "Use when reviewing commits that remediate security audit findings, verifying patches, or checking fixes for regressions."

Include natural synonyms users would say — "remediation", "patch review", "security fix", "regression" — to broaden trigger coverage.

Split the single action into two concrete capabilities, e.g. "verify the fix resolves the reported finding and check the diff for newly introduced vulnerabilities."

DimensionReasoningScore

Specificity

The description names its domain ("fix commits", "audit findings") and one concrete action ("verify fix commits address audit findings"), matching the anchor 'Names domain and 1-2 concrete actions, but not comprehensive'. It does not list several specific actions (not 4), but it goes beyond the bare domain-naming of score 2 by stating what is verified and the no-regression condition ("without new bugs").

3 / 5

Completeness

The 'what' is clear ("Verify fix commits address audit findings without new bugs") but there is no 'Use when...' clause or equivalent trigger guidance, matching 'Has a clear what but when is missing or only weakly implied'. Per the judging guidelines, a missing 'Use when...' clause caps completeness at 3; it is not 2 because the 'what' is specific, and not 4 because no 'when' is present at all.

3 / 5

Trigger Term Quality

It contains relevant keywords ("fix commits", "audit findings", "bugs") but misses natural variations users would say such as "remediation", "patch", "security fix", or "regression", matching 'Some relevant keywords but missing common variations or synonyms'. It is not at 4 because coverage of natural phrasings is thin, and not at 2 because the terms present are domain-appropriate rather than generic.

3 / 5

Distinctiveness Conflict Risk

The audit-remediation verification niche ("fix commits", "audit findings") is mostly distinct, with only minor overlap risk against closely related general code-review skills, matching 'Mostly distinct; minor overlap risk with closely related skills'. It is not 5 because it lacks distinctive trigger phrases that would fully separate it from generic review skills, and not 3 because the audit-finding context is a clearly narrower niche than 'Works with document files'.

4 / 5

Total

13

/

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

administrakt0r/AI-Agents-Safe-Coding-Skills

Path

plugins/AI-Agents-Safe-Coding-Skills-claude/skills/fix-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.