md-review

A skill that lets Claude run the standard review loop end-to-end using the mdxg-redline CLI. One round consists of the following steps:

Prepare the target markdown (read an existing .md, have Claude generate one, or use the path specified by the user via $ARGUMENTS)
Run scripts/request-review.sh <input.md> to generate the review HTML and launch the browser; capture the REVIEW_HTML / FEEDBACK_JSON paths from stdout
Run scripts/wait-feedback.sh <feedback.json> to poll until the feedback.json appears
Read the detected feedback.json and apply the comments to the markdown
Send the updated markdown out for another review
Ask the user whether to proceed to the next round, clean up review artifacts and finish, or finish as-is

The reviewer needs time to write comments (minutes to hours), so Claude's turn is free during polling — either work on other tasks or sleep.

Trigger patterns

Auto-triggering: When the user says things like "send this for review", "I want a human review", "mdxg-redline", "redline", etc., Claude automatically selects this skill based on the description
Slash command: When the user explicitly runs /md-review path/to/markdown.md, that argument is used as INPUT_MD. If the argument is empty or natural language, Claude identifies the markdown from context
Natural language path: When the user says something like "send docs/spec.md out for review" with an embedded path, that path is used as INPUT_MD