agentleFS
lucasyhzhu-debuglucasyhzhu-debug/claude-skills/skills/triple-persona-review/SKILL.md

triple-persona-review

Skill0 starsChanged 3 months agoMITView on GitHub

Use when reviewing a draft (essay, pitch deck, marketing copy, ADR, README, talk script, proposal) for cross-audience editorial pressure — dispatches three calibrated reader personas in parallel and consolidates their feedback into a prioritised editing report. Triggers on phrases like "review my draft", "what would my audience think", "is this ready to ship", "audience review", "persona review", "editorial pressure-test", "triple review". Personas pull from a reusable library and are calibrated over rounds.

1 other project uses a version of this.

Adopted by

Most recently taken up by

  • Other versions1 project uses a version of this.

    Word for word · 1

    1. lucasyhzhu-debug/triple-persona-review★ 1100% same

    Edited · 0

    None found.

    Wrote their own version · 0

    None found.

    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 repository7 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, 6 are distinctive, and 3 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈6

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 3

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    After a major rewrite — to check whether the rewrite serves all readers or only one.

    line 26
  2. Distinctive:

    Do NOT use for:

    line 29
  3. Distinctive:

    Read the artifact. Identify the audiences who will actually read it.

    line 76
  4. Very specific:

    If no matching persona exists, write a new one using briefing-template.md.

    line 87
  5. Very specific:

    Use the Agent tool with subagent_type: general-purpose.

    line 91
  6. Distinctive:

    Treat tradeoff points with care: surface the choice, name what each persona wanted, recommend a resolution but make clear it's a …

    line 115
  7. Very specific:

    If invoked from another skill (e.g.

    line 119
  8. Distinctive:

    If standalone, hand the report to the author.

    line 121
  9. Distinctive:

    Every persona returns exactly this format.

    line 135

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

Triple Persona Review

Overview

Most draft-review feedback fails because it averages. Asking one editorial agent returns smoothed-good prose; asking one reader returns one perspective. Both produce less signal than they look like they produce.

The triple-persona pattern produces more signal by deliberately choosing three readers whose interests do not align, dispatching them in parallel, and treating the contradictions in their feedback as the most useful data. If Persona A loves a paragraph and Persona B finds it preachy, that paragraph is a deliberate audience tradeoff — knowing which side to optimise for is the editorial decision.

Outputs:

  • Three independent persona reviews, each in a rigid structured format.
  • A consolidated editing report with consensus issues, tradeoff points, outlier flags, and prioritised edits — handed to the author or to whatever skill produced the draft.

The persona library at personas/ grows over time. After each round, calibrate the personas that returned soft, aligned, or off-target feedback.

When to Use

Use when:

  • A draft is structurally complete but you want pressure-test feedback before shipping.
  • The author wants editorial feedback that isn't averaged-good — distinct readers with distinct biases.
  • The piece has multiple plausible audiences and the author wants to see how each will read it.
  • After a major rewrite — to check whether the rewrite serves all readers or only one.
  • A skill like crafting-portfolio-essays has produced a draft and the author wants the next iteration's audit input.

Do NOT use for:

  • Mechanical copyediting — wrong tool.
  • Drafts at skeleton level — wait until prose is real, three readers will only complain about the obvious.
  • Code review or correctness checks — this is editorial / audience pressure-test only.
  • One-off "is this any good?" — you'll get three answers; the author needs to be ready for that.
  • Pieces with one true audience — single-persona review is fine.

The Iron Rules

1. Three is the default; never exceed five. Two readers can agree (single signal) or disagree (which is right?). Three produces triangulation: consensus + tradeoff + outlier. Past five, consolidation overhead exceeds marginal information.

2. Personas must include reward AND penalise calibration. Generic personas ("a senior executive") produce generic feedback. The reward/penalise structure is what produces specific, actionable critique. See briefing-template.md.

3. Dispatch in parallel — always. Three sequential agent calls cost 3× wall-clock for the same output. Use a single message with three Agent tool blocks.

4. The output format contract is rigid. Consolidation depends on it. Free-form persona prose breaks the report. Enforce the format in every dispatch.

5. Tradeoff points are the most useful signal — never average them away. The consolidation report must distinguish consensus / tradeoff / outlier. If you smooth tradeoffs into "consider revising", you've thrown away the actual editorial decision.

6. Personas drift — calibrate every 3–4 rounds. Append to the persona's calibration log when their feedback was soft, indistinguishable from another persona, missed an obvious flaw, or was wrong about something the author knew was right.

Workflow

digraph workflow {
    rankdir=LR;
    "1. PICK\nor BUILD\npersonas (3)" [shape=box];
    "2. DISPATCH\nin parallel" [shape=box];
    "3. CONSOLIDATE\neditingreport" [shape=box];
    "4. HAND OFF\nto author or\nupstream skill" [shape=box];
    "5. CALIBRATE\npersona files" [shape=box];

    "1. PICK\nor BUILD\npersonas (3)" -> "2. DISPATCH\nin parallel";
    "2. DISPATCH\nin parallel" -> "3. CONSOLIDATE\neditingreport";
    "3. CONSOLIDATE\neditingreport" -> "4. HAND OFF\nto author or\nupstream skill";
    "3. CONSOLIDATE\neditingreport" -> "5. CALIBRATE\npersona files";
}

Phase 1 — Pick or Build Personas

Read the artifact. Identify the audiences who will actually read it.

For most portfolio essays, the canonical three are:

  • Senior peer / executive — could refer or hire the author.
  • Builder / follower — sits in the inbound funnel for the author's content.
  • Potential client — evaluating the author commercially.

For other artifact types, see personas/README.md for guidance on archetype selection.

Match against personas/ library. Each persona file follows briefing-template.md and includes identity, reading context, reward profile, penalise profile, voice/verdict format, and a calibration log.

If no matching persona exists, write a new one using briefing-template.md. Add to the library.

Phase 2 — Dispatch in Parallel

Use the Agent tool with subagent_type: general-purpose. Send all three in a single message with three Agent tool blocks so they run concurrently.

Each agent receives:

  • Their persona briefing (full text from personas/{name}.md).
  • The artifact path(s) to read.
  • Author / context (2–3 sentence brief about the writer and the piece).
  • The output format contract.
  • A length cap (default 600 words per persona).

See briefing-template.md §"Dispatch prompt" for the exact template.

Phase 3 — Consolidate

Synthesise into a single editing report at {drafts-or-docs}/editing-report-{slug}.md using the schema in consolidation-template.md.

Required sections:

  • Executive summary — one paragraph: what's working, the main fix.
  • Verdict tally — table of each persona's reader-action verdict.
  • Consensus issues (2/3 or 3/3) — high-priority edits.
  • Tradeoff points — where personas disagreed; framed as a decision for the author, not averaged.
  • Outlier flags (1/3) — judgment calls, often domain-specific.
  • Prioritised edit list — P0 / P1 / P2 with paragraph-level specificity.
  • Open questions for the author.

Treat tradeoff points with care: surface the choice, name what each persona wanted, recommend a resolution but make clear it's a decision, not a fix.

Phase 4 — Hand Off

If invoked from another skill (e.g. crafting-portfolio-essays), the editing report becomes the next iteration's Phase 1 audit input. The upstream skill consumes it.

If standalone, hand the report to the author.

Phase 5 — Calibrate (after the round)

Append to personas/{name}-calibration.md (or to the calibration log inside the persona file) when:

  • A persona returned feedback indistinguishable from another persona → they need more reward/penalise differentiation.
  • A persona was wrong about something the author knew was right → tighten the briefing.
  • A persona missed an obvious flaw → add to their reward/penalise profile.
  • A persona drifted out of voice → re-read the briefing for tone calibration.

Calibration is what makes the library a long-lived asset rather than a one-off cast.

The Output Format Contract (per persona)

Every persona returns exactly this format. Enforced in dispatch.

## Persona
{Name + one-line capsule}

## What landed
{3–5 bullets, each citing a specific sentence/paragraph and explaining why it worked FOR THAT PERSONA. Quote sparingly.}

## What didn't land
{3–5 bullets, specific evidence, same level of citation as What landed.}

## Specific edit recommendations
{2–4 actionable edits. Format: "§{section} paragraph {n}: {what to change} — {why for your persona}".}

## Overall reaction (one sentence)
{In the persona's voice.}

## Reader-action verdict
{One of the persona-specific options — e.g. "I would take the call" / "I would share this" / "I would not engage" — followed by a 10–15 word reason.}

Common Mistakes

MistakeFix
Sending personas sequentially instead of parallelSingle message, three Agent tool blocks.
Persona without reward/penalise calibrationAdd. Generic personas → generic feedback.
Free-form prose in persona outputEnforce the format contract in the dispatch prompt.
Treating consensus and outlier issues with equal weightConsensus = high-priority; outlier = judgment call. The report must distinguish.
Smoothing tradeoff points away in consolidationTradeoffs are the most useful signal. Surface them; don't average them.
Never updating personasCalibration step exists for a reason. Personas drift.
Writing four personas because "more is better"Past five, the consolidation cost exceeds marginal info. Three is calibrated.
Using personas for code review or factual correctnessWrong tool. Editorial / audience pressure-test only.
Skipping the persona briefings ("they already know the context")Subagents have no context. Pass the full briefing every dispatch.

Files in This Skill

  • SKILL.md (this file) — workflow, iron rules, output format contract, common mistakes.
  • briefing-template.md — schema for writing a new persona; full dispatch prompt template.
  • consolidation-template.md — schema for the editing report.
  • personas/ — the persona library (one .md per persona). See personas/README.md.

Companion Skills

  • crafting-portfolio-essays — produces the drafts that feed naturally into this skill at Phase 5.5 of its workflow. Editing report becomes the next iteration's audit input.

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.