mrsf-review

Category: Docs & Knowledge | Uploader: wictorwilen | Downloads: 0 | Version: v1.0（Latest）

Review Markdown documents using the MRSF (Sidemark) sidecar format. Use when asked to review, comment on, or provide feedback on Markdown files. Adds structured, anchored review comments via the MRSF MCP server.

Changelog: Source: GitHub https://github.com/wictorwilen/MRSF

Directory Structure

Current level: examples/mrsf-review/

📄 SKILL.md 1.9 KB

SKILL.md

---
name: mrsf-review
description: Review Markdown documents using the MRSF (Sidemark) sidecar format. Use when asked to review, comment on, or provide feedback on Markdown files. Adds structured, anchored review comments via the MRSF MCP server.
license: MIT
allowed-tools: mrsf/*
metadata:
  author: wictorwilen
  version: "1.0"
---

# MRSF Document Review

You review Markdown documents by adding structured, anchored comments using the MRSF MCP server tools.

## Setup

The MRSF MCP server must be available. It provides these tools: `mrsf_discover`, `mrsf_validate`, `mrsf_add`, `mrsf_list`, `mrsf_resolve`, `mrsf_reanchor`, `mrsf_status`, `mrsf_rename`, `mrsf_delete`, `mrsf_repair`, `mrsf_help`.

## Workflow

1. **Discover** the sidecar for the target document using `mrsf_discover`.
2. **Check existing comments** with `mrsf_list` (use `summary: true` for an overview).
3. **Read the document**, then **add comments** with `mrsf_add` for each issue found. Always provide:
   - `document`: path to the Markdown file
   - `text`: your review comment
   - `author`: your identity (e.g. "AI Reviewer (copilot)")
   - `line`: the line number where the issue occurs
   - `type`: one of `suggestion`, `issue`, `question`, `accuracy`, `style`, `clarity`
   - `severity`: `low`, `medium`, or `high`
4. **Validate** the sidecar with `mrsf_validate` after adding comments.
5. **Summarize** what you found using `mrsf_list` with `summary: true`.

## Comment Guidelines

- Anchor every comment to a specific line (use `line` and optionally `end_line`).
- Use `type` to categorize: `accuracy` for factual issues, `clarity` for confusing prose, `suggestion` for improvements, `style` for formatting.
- Set `severity: high` for factual errors or broken instructions, `medium` for clarity issues, `low` for style nits.
- For follow-ups on existing comments, use `reply_to` with the parent comment ID.
- After the document is edited, run `mrsf_reanchor` to update comment positions.

Comments 0

Latest | Hot

Please login before commenting.

No comments yet. Be the first one!

mrsf-review

Directory Structure

SKILL.md

Report

Notice