mrsf-review
starsforks
How to install mrsf-review?
wictorwilen/mrsf/mrsf-review
$npx -y skills add wictorwilen/MRSF --skill mrsf-reviewReview 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.
SKILL.md
| 1 | # MRSF Document Review |
| 2 | |
| 3 | You review Markdown documents by adding structured, anchored comments using the MRSF MCP server tools. |
| 4 | |
| 5 | ## Setup |
| 6 | |
| 7 | 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`. |
| 8 | |
| 9 | ## Workflow |
| 10 | |
| 11 | 1. **Discover** the sidecar for the target document using `mrsf_discover`. |
| 12 | 2. **Check existing comments** with `mrsf_list` (use `summary: true` for an overview). |
| 13 | 3. **Read the document**, then **add comments** with `mrsf_add` for each issue found. Always provide: |
| 14 | - `document`: path to the Markdown file |
| 15 | - `text`: your review comment |
| 16 | - `author`: your identity (e.g. "AI Reviewer (copilot)") |
| 17 | - `line`: the line number where the issue occurs |
| 18 | - `type`: one of `suggestion`, `issue`, `question`, `accuracy`, `style`, `clarity` |
| 19 | - `severity`: `low`, `medium`, or `high` |
| 20 | 4. **Validate** the sidecar with `mrsf_validate` after adding comments. |
| 21 | 5. **Summarize** what you found using `mrsf_list` with `summary: true`. |
| 22 | |
| 23 | ## Comment Guidelines |
| 24 | |
| 25 | - Anchor every comment to a specific line (use `line` and optionally `end_line`). |
| 26 | - Use `type` to categorize: `accuracy` for factual issues, `clarity` for confusing prose, `suggestion` for improvements, `style` for formatting. |
| 27 | - Set `severity: high` for factual errors or broken instructions, `medium` for clarity issues, `low` for style nits. |
| 28 | - For follow-ups on existing comments, use `reply_to` with the parent comment ID. |
| 29 | - After the document is edited, run `mrsf_reanchor` to update comment positions. |
People who liked this also viewed
6 picksType
- requesting-code-reviewUse when completing tasks, implementing major features, or before merging to verify work meets requirementsSkillsJul 2026
- code-reviewSkills for Real Engineers. Straight from my .agents directory.SkillsJul 2026
- receiving-code-reviewUse when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performativeSkillsJul 2026
- baoyu-format-markdownFormats plain text or markdown files with frontmatter, titles, summaries, headings, bold, lists, and code blocks. Use when user asks to "format markdown", "beautify article", "add formatting", or imprSkillsJul 2026
- code-review-excellenceMaster effective code review practices to provide constructive feedback, catch bugs early, and foster knowledge sharing while maintaining team morale. Use when reviewing pull requests, establishing reSkillsJul 2026
- code-review-and-qualityConducts multi-axis code review. Use before merging any change. Use when reviewing code written by yourself, another agent, or a human. Use when you need to assess code quality across multiple dimensiSkillsJul 2026
