humanistic-reviewer

name

humanistic_reviewer

description

Audit any draft copy for AI slop, generic filler, voice mismatch, and weak structure. Use this skill after any writing engine produces output — always run before delivering copy to the user. Also trigger when the user says "review this copy", "edit this", "make this less AI-sounding", "punch this up", "is this good enough to send", or pastes copy and asks for feedback. Returns a score, flagged issues, revision instructions, and optionally a rewritten draft.

Skill: humanistic_reviewer

Purpose

Audit draft copy for AI slop, generic filler, voice mismatch, and low signal. Provide targeted feedback, keep the strongest parts, and optionally rewrite.

---

Inputs

Field	Type	Default	Description
draft_copy	text	required	Copy to review
asset_type	enum	required	email, webinar, funnel_page, website, ad
brand_voice	string[]	["direct", "no-BS", "punchy", "mentor-not-guru"]	2–4 adjectives
audience	string	required	Short description of who this is for
max_length	int	optional	Desired length ceiling
strictness_level	int 1–3	2	1=lenient, 2=normal, 3=ruthless
rewrite_threshold	int 0–10	6	Score below this triggers auto-rewrite
auto_rewrite	boolean	false	If true, produce revised_draft in output

---

Outputs

Field	Type	Description
overall_score	int 0–10	Quality score
slop_flags	array	Issues found (see structure below)
revision_instructions	string[]	3–7 actionable bullets
keep_sections	string[]	Strong excerpts to preserve
rewrite_needed	boolean	True if score < rewrite_threshold
revised_draft	text	Only present if auto_rewrite=true or rewrite_needed=true

slop_flags structure

{
  "type": "generic | repetitive | bloated | robotic | off_brand | unclear | cliche | weak_hook | buried_cta",
  "excerpt": "exact text from draft",
  "issue_explanation": "why this is a problem",
  "suggested_fix": "specific replacement or direction"
}

---

Behavior Rules

1. Kill Generic Filler

Flag and require replacement for:

• "in today's fast-paced world"
• "ever-changing landscape"
• "leverage the power of"
• "unlock your potential"
• "game-changing" / "groundbreaking" / "revolutionary"
• "journey" (when used metaphorically)
• "dive deep" / "deep dive"
• "at the end of the day"
• "it's no secret that"
• "more than ever before"

Rule: Replace with specific, concrete language. No exceptions.

2. Kill Over-Explaining

• Flag intros longer than 3 sentences before any value is delivered.
• Flag the same idea stated more than once in different words.
• Instruct cuts, not rewrites of bloat.

3. Enforce Clear Thinking

• Ask: "What is the single core idea?"
• If the copy tries to say 3 things, flag it: "Pick one. What does the reader need to believe to take action?"
• Require that the core idea appears in the first 3 sentences.

4. Enforce Voice Alignment

Compare draft tone against brand_voice. Flag mismatches:

• Too formal vs "direct/no-BS" → flag as off_brand
• Too casual vs "premium" → flag as off_brand
• Guru-speak vs "mentor-not-guru" → flag as off_brand

5. Enforce Asset-Specific Fit

Ads:

• Hook must be in the first sentence. If not → weak_hook.
• One idea only. Multiple angles in one ad → bloated.
• CTA must be explicit. Vague ending → buried_cta.

Emails:

• Subject line must create curiosity or state a clear benefit. No puns that don't land.
• One primary CTA. Two CTAs → flag as bloated.
• Skimmable: long unbroken paragraphs (>4 lines) → flag as bloated.

Webinar copy:

• Big idea must be visible in the headline. Generic outcome → unclear.
• Proof must be specific. Vague testimonials → generic.
• Bullet list features without outcomes → flag as generic.

Sales / funnel pages:

• Above-fold must answer: What is this? Who is it for? Why now?
• Missing any of three → unclear.
• Guarantee must be specific. "100% satisfaction" alone is weak → flag.

---

Scoring Guide

Score	Meaning
9–10	Ship it. Strong hook, clear idea, voice-matched, proof-specific.
7–8	Good. Minor polish needed. No structural rewrites.
5–6	Weak. Structural issues. Requires meaningful revision before shipping.
3–4	Not ready. Core idea is unclear or voice is off. Full rewrite recommended.
0–2	Start over. Generic, hallucinated, or completely off-brand.

A score below rewrite_threshold (default: 6) sets rewrite_needed: true.

If auto_rewrite: true or rewrite_needed: true, produce a revised_draft that:

• Applies all revision instructions
• Preserves all keep_sections
• Does not invent new proof; keeps placeholders
• Matches brand_voice

---

Example Revision Instructions (Pattern)

• "Cut 20–30% by removing repeated points and vague phrases."
• "Move the core promise into the first 2 sentences."
• "Replace '[generic adjective]' with a specific outcome — time saved, revenue added, or pain removed."
• "Sharpen the CTA to one clear action. Remove the secondary link."
• "The subject line is clever but unclear. Swap for benefit-forward: tell them what's inside."
• "The opening paragraph is preamble. Delete it. Start at line 3."
• "Replace '[testimonial placeholder]' with a real name, result, and timeframe."