CtrlK
BlogDocsLog inGet started
Tessl Logo

md-review

Converts a markdown PR writeup or code review (one with ```diff fenced blocks and severity-tagged > [!BLOCKER]/[!MAJOR]/[!MINOR]/[!NIT] callouts) into a single-file 2-column HTML review — unified-diff on the left, severity-tagged annotation cards on the right, top jump-nav listing every finding, mandatory named reviewer footer. Triggers when the markdown-html-orchestrator classifies an input as REVIEW, or when invoked directly via /cs:md-review. Refuses without explicit --reviewer (a code review must name a human), refuses if no diff hunks present (route to md-document instead), and refuses to encode severity in color only (every badge ships color + icon + aria-label per WCAG 1.4.1). Use after orchestrator routing.

71

Quality

87%

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

The canonical home for this skill is md-review in alirezarezvani/claude-skills

SKILL.md
Quality
Evals
Security

Quality

Content

82%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.

A well-structured, highly actionable skill body with a clear pipeline and explicit refusal-based validation gates. It loses points for some attribution padding in the forcing-question section and for referencing bundle files that do not exist.

Suggestions

Trim the 'Canon:' attributions from the forcing-question library; keep the recommended action and drop the book-chapter citations to save tokens.

Add an explicit output-verification step (e.g. open/validate review.html or check exit code) after the render command to close the workflow-validation gap.

Either ship the referenced `references/` citation files and `scripts/` pipeline scripts in the bundle, or remove the 'See references/ for full citations' pointer to avoid dangling references.

DimensionReasoningScore

Conciseness

Mostly lean with tight tables and copy-paste commands, but the 'Forcing-question library' section pads each item with 'Recommended:'/'Canon:' attributions that could be trimmed.

4 / 5

Actionability

Provides fully executable, copy-paste-ready three-step bash pipeline with explicit flags and output files covering the common case end-to-end.

5 / 5

Workflow Clarity

The parse → extract → render sequence is clearly numbered, and refusal gates (exit 3/4, <100-line check) act as input validation, but there is no explicit output-verification checkpoint.

4 / 5

Progressive Disclosure

Well-organized single-file overview with signaled references, but the body points to a `references/` directory and `scripts/` paths that are not present in the bundle, leaving those citations dangling.

4 / 5

Total

17

/

20

Passed

Description

92%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 tight, third-person description that concretely states both the output artifact and the trigger conditions, with explicit refusal gates that sharpen its niche. Minor trigger-term synonym coverage keeps it just short of perfect.

DimensionReasoningScore

Specificity

Lists multiple concrete actions — 'unified-diff on the left, severity-tagged annotation cards on the right, top jump-nav listing every finding, mandatory named reviewer footer' — giving comprehensive coverage of what the skill produces.

5 / 5

Completeness

Explicitly answers both what ('Converts a markdown PR writeup ... into a single-file 2-column HTML review') and when ('Triggers when the markdown-html-orchestrator classifies an input as REVIEW, or when invoked directly via /cs:md-review').

5 / 5

Trigger Term Quality

Covers natural terms a user would say ('code review', 'PR writeup', 'diff') plus invocation triggers ('/cs:md-review', 'markdown-html-orchestrator'), but leans technical and omits some common synonyms.

4 / 5

Distinctiveness Conflict Risk

A clear niche (code-review markdown with diff hunks → HTML), with explicit routing away from md-document/md-slides, minimizing conflict risk.

5 / 5

Total

19

/

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.

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
alirezarezvani/claude-skills
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.