Back to marketplace

Md Review

Converts a markdown code review — fenced \`\`\`diff blocks plus severity callouts like \`[!BLOCKER]\`, \`[!MAJOR]\`, \`[!MINOR]\`, \`[!NIT]\` — into a single-file.

Docs & Writing / Docs and Formattingdocs-writingdocs-and-formatting
by AgentVoltv1.0.0Published 1y ago1 install
Free to sign up · every skill included with AgentVolt Pro

Before & after

Same prompt, same agent — the only difference is the skill.

Prompt“Convert my markdown code review into an interactive HTML report.”
Beforegeneric AI agent
You could take your markdown review and make it into HTML so it's easier to read. You'd want to show the code changes on one side and your comments on the other. Different types of issues might be color-coded or labeled so readers can see what's important. You'd probably want a table of contents at the top so people can jump to specific sections. It's better if it's a single file so you don't have to worry about multiple files when you share it. Comments should be clear about what the issue is and how to fix it.
Afterwith Md Review
I'll convert your markdown code review (with diff blocks and severity tags) into a self-contained HTML side-by-side review document.

INPUT FORMAT
Write your review in markdown with:
```diff blocks: the code changes you're reviewing
> [!BLOCKER] critical issues that must be fixed before merge
> [!MAJOR] should-fix issues that weaken the PR
> [!MINOR] nice-to-have improvements
> [!NIT] stylistic notes

OUTPUT DOCUMENT
Single-file HTML (no dependencies, download and open anywhere).

LAYOUT
Left column (60 percent): Unified diff, line numbers, syntax highlighting
Right column (40 percent): Severity-tagged annotation cards, each pinned to the exact line it references
Top navigation: Jump list of all findings, grouped by severity

VISUAL HIERARCHY
BLOCKER findings (red icon + label): Critical, must fix before merging
MAJOR findings (orange): Should fix, agreed on before ship
MINOR findings (yellow): Polish, consider for future
NIT findings (gray): Trivial style notes

Each card shows:
• Severity icon + label
• Line number(s) affected
• Reviewer's comment
• Suggested fix (if provided)

FOOTER
Mandatory reviewer name + date (skill requires --reviewer flag; review is unsigned without it)

EXAMPLE
A 50-line PR with 3 blockers, 2 majors, 1 minor. Your HTML shows the full diff on the left, each comment pinned to its line on the right. Reader can click "BLOCKER" in the jump nav, focus on those 3 issues, then fix and re-submit.

About this skill

name: md-review description: Use when 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-d...

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.

What you get

  • Public GitHub repo (alirezarezvani/claude-skills)
  • the md-review skill folder with SKILL.md. Part of a 337-skill / 30-agent / 70-command install.

Customize your output

  • Fork the repo and adapt the skill's instructions and references to your workflow.

Example output

Activates automatically when your request matches Md Review; chains with the other skills, agents, and commands in the collection.

Best for

Creators, builders, and teams using Claude Code.

SKILL.md preview

SKILL.md
---
name: md-review
description: Use when converting a markdown PR writeup or code review with diff blocks and severity-tagged callouts into a polished, accessible, single-file HTML review document.
version: 1.0.0
category: Docs & Writing / Docs and Formatting
author: AgentVolt
license: proprietary
tags:
  - docs-writing
  - docs-and-formatting
---

# Md Review

Converts a markdown code review — fenced \`\`\`diff blocks plus severity callouts like \`[!BLOCKER]\`, \`[!MAJOR]\`, \`[!MINOR]\`, \`[!NIT]\` — into a single-file, two-column HTML review page: unified diff on the left, annotation cards on the right, a jump-nav listing every finding, and a named reviewer footer.

## When to use

… (sign up to view the full skill)
Sign up to view, copy, and install the full skill

More content & writing skills

View all Content & Writing skills →

Markdown HTML Orchestrator

Routes a markdown file to the right converter — long-form document, code review with diffs, or slide deck — and renders it as a single self-contained interactive HTML file.

Content & Writing

Md Slides

Converts a markdown deck (slides separated by `

Content & Writing

Design System

Captures the user's brand identity once via a 10-question onboarding wizard, validates contrast, derives CSS custom properties.

Content & Writing

Md Document

Converts long-form markdown into a single-file HTML document with a sticky table of contents, scrollspy, search filtering, code-copy buttons, and brand-token styling.

Content & Writing