prose-review SKILL.md skillA

prose-review from rustyrazorblade/skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add rustyrazorblade/skills/prose-review@git:20260905.9b24bd0

Pins git:20260905.9b24bd0 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
rustyrazorblade/skills
Path
plugins/dev-skills/skills/prose-review/SKILL.md
Versions recorded
3
Latest version
git:20260905.9b24bd0, committed Sep 5, 2026
First version recorded
Aug 26, 2026
Size
15,892 bytes
Repository stars
44
License
Apache-2.0

Grade the prose in a patch against prose-style.md and report the findings; apply them with --fix. Covers code comments and javadoc by default, and commit messages, the PR description, or release notes when asked. Use this skill when the user asks to review, audit, grade, clean up, fix, tidy, or restyle comments, javadoc, commit messages, a PR description, or release notes, says "the comments need work", "check the prose on this branch", "do a comment pass", or asks for prose-style.md to be…

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Prose review

Grade every in-scope passage against `prose-style.md`.  Report the findings.  Apply them only when
Jon passes `--fix`.

You judge words.  You never judge code, and you never edit code.

Grader agents do the grading.  You resolve the scope, you merge their findings, and you apply them.
Sections 1 to 5 and 8 to 9 are your work.  Sections 6 and 7 are the contract you hand to a grader.

## 1. Read the style reference first

`prose-style.md` is the authority.  Read the whole file before you grade a single passage.  Do not
work from memory of it.

Find it in this order:

1. `prose-style.md` at the current repo root.
2. `prose-style.md` in a parent directory, walking up.
3. `${CLAUDE_PLUGIN_ROOT}/references/prose-style.md`, this plugin's bundled copy.

A repo's own copy always wins; the bundled copy is the fallback, so the skill works in a repo that
has no copy of its own.  Never hardcode a path to a copy in some other repo.  If you find no copy
at all, stop and say so.  Do not substitute general style knowledge.

Resolve the path to an absolute path and keep it.  Every grader gets that path and reads the file
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add rustyrazorblade/skills/prose-review@sha256:8c72cabaf8b1bc09

The line at the top of this page pins the label git:20260905.9b24bd0, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_zqsiyebg4oezzmr6.svg)](https://markdownregistry.com/a/art_zqsiyebg4oezzmr6)

5 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 3 versions of this file, between Aug 26, 2026 and Sep 5, 2026, about one every 5 days.

versioncommittedcommitsizeaudit
git:20260905.9b24bd0 latest2026-09-05 9b24bd0 15,892 BA view · diff
git:20260903.1b94fd82026-09-03 1b94fd8 15,891 BA view · diff
git:20260826.33297a22026-08-26 33297a2 11,419 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (15892 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

rustyrazorblade/skills · 44 stars · license Apache-2.0 · pushed 2026-10-31 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_zqsiyebg4oezzmr6
GET https://markdownregistry.com/api/v1/resolve?ref=rustyrazorblade/skills/prose-review
GET https://markdownregistry.com/api/v1/blob/8c72cabaf8b1bc09846d3afe9fc9330760b627930c5813dcb69bb8a2ec649353

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from rustyrazorblade/skills

openspec-apply-change SKILL.md skill
rustyrazorblade/skills · .claude/skills/openspec-apply-change/SKILL.md · Implement tasks from an OpenSpec change. Use when the user wants to start implementing, continue implementation, or…
v1.0 · audit A · 44 stars
openspec-archive-change SKILL.md skill
rustyrazorblade/skills · .claude/skills/openspec-archive-change/SKILL.md · Archive a completed change in the experimental workflow. Use when the user wants to finalize and archive a change after…
v1.0 · audit A · 44 stars
openspec-bulk-archive-change SKILL.md skill
rustyrazorblade/skills · .claude/skills/openspec-bulk-archive-change/SKILL.md · Archive multiple completed changes at once. Use when archiving several parallel changes.
v1.0 · audit A · 44 stars
openspec-explore SKILL.md skill
rustyrazorblade/skills · .claude/skills/openspec-explore/SKILL.md · Enter explore mode - a thinking partner for exploring ideas, investigating problems, and clarifying requirements. Use…
v1.0 · audit A · 44 stars
openspec-onboard SKILL.md skill
rustyrazorblade/skills · .claude/skills/openspec-onboard/SKILL.md · Guided onboarding for OpenSpec - walk through a complete workflow cycle with narration and real codebase work.
v1.0 · audit A · 44 stars
openspec-propose SKILL.md skill
rustyrazorblade/skills · .claude/skills/openspec-propose/SKILL.md · Propose a new change with all artifacts generated in one step. Use when the user wants to quickly describe what they…
v1.0 · audit A · 44 stars
openspec-sync-specs SKILL.md skill
rustyrazorblade/skills · .claude/skills/openspec-sync-specs/SKILL.md · Sync delta specs from a change to main specs. Use when the user wants to update main specs with changes from a delta…
v1.0 · audit A · 44 stars
openspec-verify-change SKILL.md skill
rustyrazorblade/skills · .claude/skills/openspec-verify-change/SKILL.md · Verify implementation matches change artifacts. Use when the user wants to validate that implementation is complete…
v1.0 · audit A · 44 stars
CLAUDE.md CLAUDE.md file
rustyrazorblade/skills · CLAUDE.md
git:20260907.450260a · audit A · 44 stars
data-model SKILL.md skill
rustyrazorblade/skills · plugins/cassandra-expert/skills/data-model/SKILL.md · Data modeling and schema design for Apache Cassandra. Use when designing tables, choosing partition keys, modeling…
git:20261031.8909b5e · audit A · 44 stars
diagnose SKILL.md skill
rustyrazorblade/skills · plugins/cassandra-expert/skills/diagnose/SKILL.md · Systematic troubleshooting for Apache Cassandra clusters. Use when diagnosing performance issues, latency problems…
git:20261031.8909b5e · audit A · 44 stars
optimize SKILL.md skill
rustyrazorblade/skills · plugins/cassandra-expert/skills/optimize/SKILL.md · Performance optimization for Apache Cassandra clusters. Use when tuning configuration, improving throughput, reducing…
git:20261031.8909b5e · audit A · 44 stars

Every file in rustyrazorblade/skills

Browse by kind, by grade A, or by owner.