persona-review
Skill1 starsChanged 42 days agoMITView on GitHub
Review a text through a chosen reviewer persona. Identifies issues from that persona's perspective and applies targeted surgical fixes. Preserves the owner persona as primary author unless explicitly told otherwise.
2 other projects use a version of this.
Adopted by
Most recently taken up by
- Vinay-R/vibe-engineering-templatetheir own version, first seen Nov 1, 2026
- clinton3141/skillstheir own version, first seen Oct 25, 2026
Other versions2 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 2
- clinton3141/skills★ 0same name
- Vinay-R/vibe-engineering-template★ 0same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository8 other files it gives its agents.
- persona-briefSkill
- persona-copySkill
- persona-createSkill
- persona-listSkill
- persona-localizeSkill
- persona-researchSkill
- persona-wordcheckSkill
- persona-writeSkill
The file
We split this skill into the rules it gives an agent
9 rules. About 0 are common, 7 are distinctive, and 2 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈7
Distinctive · estimate
This author's own choices. Worth a look.
2
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 10
Use this skill when you want a specific reviewer perspective applied to existing text — without handing ownership of the text to the …
- Very specific: line 34
Number the files: Use 01-owner-voice.md, 02-review-feedback.md, etc.
- Very specific: line 35
Final output: Write the final revised text to final.md in the same folder before returning it to the user.
- Distinctive: line 41
Use this skill when you want to:
- Distinctive: line 42
run a review pass through a specific lens without fully rewriting the text
- Distinctive: line 49
Do not use this skill when you want:
- Distinctive: line 60
Ask which perspective to review from.
- Distinctive: line 75
If no owner persona is stated, infer from the text's existing voice or proceed without one — still apply surgical fixes, not full …
- Distinctive: line 105
After the review pass, produce the final version and a short note explaining:
≈ “Common” is an estimate: at least 1 in 5 of the 372,429 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Persona Review
Purpose
Use this skill when you want a specific reviewer perspective applied to existing text — without handing ownership of the text to the reviewer.
This skill is for:
- getting a second-persona read on text already written or rewritten
- applying targeted improvements from a specific editorial stance
- reviewing text before publication through a sharper or differently-calibrated lens
- running a standalone review pass that
/persona-writechain mode would run internally
Core rules
- The reviewer persona is not the author. The text has an owner — that is the voice the output should primarily reflect.
- Reviewers identify problems, then apply surgical fixes. They do not ask permission before making changes.
- Reviewers do not rewrite the whole piece in their own voice.
- Reviewers do not replace the owner persona.
- Fixes should be targeted: sentence-level, paragraph-level, or local framing. Not full rewrites.
- Preserve meaning before anything else.
- The reviewer's job is to make the text better, not to make it sound like them.
Scratch folder & Pipeline traceability
To ensure the pipeline is followed and the user can see the internal reasoning, every review task must use a scratch folder.
- Create a task folder:
scratch/YYYY-MM-DD-[task-slug]/ - Record every step: Each step in the review workflow must be written to its own
.mdfile in that folder. - Number the files: Use
01-owner-voice.md,02-review-feedback.md, etc. - Final output: Write the final revised text to
final.mdin the same folder before returning it to the user.
This applies to all tasks. The scratch folder is gitignored.
When to use this skill
Use this skill when you want to:
- run a review pass through a specific lens without fully rewriting the text
- apply one reviewer persona without building a full chain
- get targeted editorial feedback from a defined perspective
- improve framing, clarity, compression, or audience fit without displacing the voice
When not to use this skill
Do not use this skill when you want:
- a full rewrite in the reviewer's voice — use
/persona-writewith that persona instead - grammar correction only — the reviewer edits with purpose, not just for correctness
- detector evasion
Main user flow
If the user gave a reviewer persona
Proceed directly.
If the user did not give a reviewer persona
Ask which perspective to review from.
List the preset options:
- sharp-technical: direct, concise, technical — cuts excess, tightens reasoning
- pragmatic-builder: practical, useful — improves clarity of action and implementation
- clear-teacher: explanatory — opens up dense reasoning, improves accessibility
- skeptical-analyst: careful, evidence-aware — identifies assumptions, weak claims, overreach
- blunt-operator: maximum compression — cuts ceremony, softness, and length aggressively
- problem-first-marketer: audience-first — improves framing, problem articulation, entry points
Also accept plain-language descriptions.
If the user has an owner persona in mind
Accept it and keep it in context. The review should preserve that owner's voice.
If no owner persona is stated, infer from the text's existing voice or proceed without one — still apply surgical fixes, not full replacement.
Review workflow
For each review task, process through the scratch folder:
Step 1: Understand the text's owner voice (01-owner-voice.md)
Before reviewing, identify:
- what persona or voice the text is currently written in
- what the text is trying to do
- who it is for
- what must be preserved
Step 2: Apply the reviewer perspective (02-review-feedback.md)
From the reviewer persona's stance, identify:
- what feels off, unclear, or misframed
- where tone is wrong for the intended audience
- where the owner persona overdid or underdid something
- what is too dense, too soft, too vague, too cold, too polished, or too weak
- where the argument, framing, or emphasis can improve
- where the text drifts from the owner persona's positive shape (Identity, Rhythm, Stylometric Signature)
Reference docs/review-principles.md and ../persona-write/docs/voice-guide.md.
Step 3: Apply surgical fixes (03-revision-draft.md)
Make targeted changes directly. Do not ask permission first.
Apply: ...
Step 4: Report what changed (final.md)
After the review pass, produce the final version and a short note explaining:
- what the reviewer identified as the main problems
- what was changed and why
- what was deliberately left alone
Return this final version to the user.
Output format
Return:
- a short reviewer summary (what the main issues were)
- the revised text with changes applied
For substantial revisions, note which sections changed and what drove the changes.
Reviewer pairings
For useful combinations, see docs/reviewer-pairings.md.
Voice coherence
The reviewer notices drift from the owner persona's positive shape — Identity, Rhythm model, Stylometric Signature, Lexical Shunts, Taboo patterns. The check is fit to the owner's positive target, not enumeration of generic AI patterns.
Reference: docs/review-principles.md and ../persona-write/docs/voice-guide.md.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

