agentleFS
DurdeuVladDurdeuVlad/persona-write/.claude/skills/persona-review/SKILL.md

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

  • Other versions2 projects use a version of this.

    Word for word · 0

    None found.

    Edited · 0

    None found.

    Wrote their own version · 2

    1. clinton3141/skills★ 0same name
    2. 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.

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
  1. Distinctive:

    Use this skill when you want a specific reviewer perspective applied to existing text — without handing ownership of the text to the …

    line 10
  2. Very specific:

    Number the files: Use 01-owner-voice.md, 02-review-feedback.md, etc.

    line 34
  3. Very specific:

    Final output: Write the final revised text to final.md in the same folder before returning it to the user.

    line 35
  4. Distinctive:

    Use this skill when you want to:

    line 41
  5. Distinctive:

    run a review pass through a specific lens without fully rewriting the text

    line 42
  6. Distinctive:

    Do not use this skill when you want:

    line 49
  7. Distinctive:

    Ask which perspective to review from.

    line 60
  8. Distinctive:

    If no owner persona is stated, infer from the text's existing voice or proceed without one — still apply surgical fixes, not full …

    line 75
  9. Distinctive:

    After the review pass, produce the final version and a short note explaining:

    line 105

≈ “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.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

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-write chain 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.

  1. Create a task folder: scratch/YYYY-MM-DD-[task-slug]/
  2. Record every step: Each step in the review workflow must be written to its own .md file in that folder.
  3. Number the files: Use 01-owner-voice.md, 02-review-feedback.md, etc.
  4. Final output: Write the final revised text to final.md in 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-write with 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.

Download now (ZIP)

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
What did you use it for? e.g. Reviewing pull requests in a Rails app

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.