Persuasion Content Auditor
by @quochungto
Audit, analyze, review, or score any persuasive content against the 6 principles of influence: reciprocity, commitment and consistency, social proof, liking,...
clawhub install bookforge-persuasion-content-auditorπ About This Skill
name: persuasion-content-auditor description: | Audit, analyze, review, or score any persuasive content against the 6 principles of influence: reciprocity, commitment and consistency, social proof, liking, authority, and scarcity. Use when someone wants to improve their copy, check their persuasion strategy, evaluate a landing page, review a sales email, audit marketing materials, or find out which influence principles they're using or missing. Triggers on: audit my copy, review my email, is this persuasive, persuasion score, influence check, analyze my landing page, make this more persuasive, improve my conversion rate, CRO review, check my sales page, why isn't this converting, which principles am I using, what's missing from my pitch, evaluate my offer, marketing copy review, persuasion audit, influence framework review, content persuasion analysis. Input: any piece of persuasive content β sales email, landing page, marketing copy, pitch deck, product page, social ad, proposal. Output: scored audit report with per-principle ratings, evidence citations, and specific rewrite recommendations. model: sonnet context: 200k execution: tier: 1 mode: full inputs: - type: document description: "Marketing content to audit β paste directly or provide as file path" tools-required: [Read] tools-optional: [Write] environment: "Works from any context; content can be pasted inline or read from file" tags: [persuasion]
Persuasion Content Auditor
When to Use
Use this skill when you have a specific piece of persuasive content that needs evaluation β a landing page, sales email, marketing copy, pitch, proposal, ad copy, or any text intended to move an audience toward an action.
This skill is appropriate when:
What makes this skill valuable: It applies all 6 scientifically validated influence principles simultaneously and scores each independently. Most content uses only 1-2 principles by accident. Intentionally applying all 6 creates compounding persuasive effect β each principle reinforces the others.
Agent: Before starting, confirm you have the content to audit. If the user says "audit my landing page" without providing it, ask them to paste the content or provide the file path. Do not proceed without actual content.
Context & Input Gathering
Required Context (must have β ask if missing)
Default Assumptions (when context cannot be gathered)
Sufficiency Threshold
PROCEED when: you have the content text AND either the intended action (or a reasonable inference from the content).
Process
Step 1: Read and Understand the Content
ACTION: Read the entire content in full before beginning any analysis. Note the overall structure, the offer, the audience signals, and the call to action.
WHY: Principles interact β a strong reciprocity element early in the piece sets up authority claims later to land harder. Evaluating principles in isolation without understanding the full arc misses compounding effects and sequencing issues.
IF content is a file path β use Read to load it ELSE β work directly from the pasted text
Step 2: Audit Each of the 6 Principles
ACTION: For each principle, evaluate: Is it present? How well is it applied? What is the specific evidence from the content?
Work through all 6 in sequence. For each principle, assign a rating and capture the evidence.
WHY: Sequential auditing ensures no principle is overlooked. Content creators typically default to whatever persuasion style feels natural to them β often 1-2 principles β and systematically miss the others. A scored checklist surfaces blind spots that intuition misses.
Use the scoring system from references/audit-rubric.md for detailed criteria. Summary ratings:
| Rating | Meaning | |--------|---------| | Strong (3) | Principle clearly present and well-executed with amplifiers active | | Weak (1) | Principle present but underexecuted β surface-level, no amplifiers | | Missing (0) | Principle entirely absent | | Counterproductive (-1) | Principle is present but applied in a way that backfires |
For each principle, document: 1. Rating (Strong / Weak / Missing / Counterproductive) 2. Evidence β quote specific phrases or elements from the content 3. What amplifiers are present or absent (see rubric)
Principle 1 β Reciprocity Look for: Does the content give something before asking? Free value (content, tools, samples, useful information), a concession structure (large ask reduced to smaller ask), or a favor that creates felt obligation.
Principle 2 β Commitment and Consistency Look for: Does the content invite small commitments that escalate? Does it ask readers to take a stance, identify with a value, or make a micro-decision that leads naturally to the main ask?
Principle 3 β Social Proof Look for: Testimonials, user counts, case studies, ratings, logos, mentions of others using the product. Are they specific (named, detailed, with results) rather than generic?
Principle 4 β Liking Look for: Does the content build rapport? Does it demonstrate shared values, shared identity, familiarity, or compliments to the reader? Does the brand/person behind the content feel warm and relatable?
Principle 5 β Authority Look for: Credentials, expertise signals, data citations, institutional affiliations, track record evidence, visual markers of professionalism. Does the content establish WHY the source should be trusted on this specific topic?
Principle 6 β Scarcity Look for: Limited quantity language, deadline language, exclusive access framing, or information-scarcity ("only available to X group"). Does the content create urgency that is credible rather than manufactured?
Step 3: Calculate Coverage Score
ACTION: Sum the 6 principle ratings. Identify how many principles are "Strong" (rating of 3).
WHY: Coverage score reveals the overall persuasive architecture at a glance. A piece with 2 strong principles and 4 missing ones is systematically under-persuasive regardless of how well-written the copy is. The goal is not necessarily to maximize all 6 simultaneously β some audiences and contexts call for restraint on certain principles β but missing 4-5 is almost always a problem.
Coverage Score:
| Coverage (principles β₯ Weak) | Assessment | |------------------------------|------------| | 5-6 principles present | Full-spectrum persuasion β evaluate depth next | | 3-4 principles present | Partial strategy β identify high-value gaps | | 1-2 principles present | Thin strategy β significant opportunity | | 0 principles present | Unpersuasive content β structural rebuild needed |
Step 4: Identify Top 3 Improvement Opportunities
ACTION: Among missing or weak principles, identify the 3 that would create the most impact if added or strengthened. Prioritize based on: (a) ease of implementation, (b) fit with the content type, (c) stage of the funnel.
WHY: Not all missing principles have equal value. Scarcity on a thought leadership article would feel manipulative. Reciprocity on a sales email is both easy to add and highly effective. The right improvement recommendations are context-specific, not a generic checklist.
Selection criteria:
Step 5: Generate Specific Rewrite Recommendations
ACTION: For each of the top 3 opportunities, produce a concrete rewrite. Do not describe what to do β show it.
WHY: Generic advice ("add social proof") is useless. Specific rewrites ("Add a testimonial from a [role similar to target audience] who achieved [specific result] in [specific timeframe], placed immediately before the CTA") give the content creator an actionable, near-final version they can implement immediately. Specific examples also demonstrate that you understand their content deeply, not just the framework.
Format for each rewrite recommendation:
Step 6: Produce the Audit Report
ACTION: Compile findings into a structured report following the template below.
WHY: A structured report makes findings actionable and shareable. The content creator should be able to hand this to a copywriter or implement it themselves without needing to re-read the analysis.
Output: Persuasion Audit Report
## Persuasion Audit Report
Content: [title or description of audited piece]
Date: [today's date]
Intended action: [what the content asks readers to do]
Principle Scores
| Principle | Rating | Score |
|-----------|--------|-------|
| Reciprocity | [Strong/Weak/Missing/Counterproductive] | [3/1/0/-1] |
| Commitment & Consistency | [Strong/Weak/Missing/Counterproductive] | [3/1/0/-1] |
| Social Proof | [Strong/Weak/Missing/Counterproductive] | [3/1/0/-1] |
| Liking | [Strong/Weak/Missing/Counterproductive] | [3/1/0/-1] |
| Authority | [Strong/Weak/Missing/Counterproductive] | [3/1/0/-1] |
| Scarcity | [Strong/Weak/Missing/Counterproductive] | [3/1/0/-1] |
| Total | | /18 |
Overall Assessment: [Full-spectrum / Partial / Thin / Unpersuasive]
Per-Principle Analysis
#### 1. Reciprocity β [Rating]
Evidence: [specific quotes or elements from the content]
Amplifiers active: [list which amplifiers apply]
Gap: [what's missing or could be stronger]
#### 2. Commitment & Consistency β [Rating]
Evidence: [specific quotes or elements from the content]
Amplifiers active: [list which amplifiers apply]
Gap: [what's missing or could be stronger]
#### 3. Social Proof β [Rating]
Evidence: [specific quotes or elements from the content]
Amplifiers active: [list which amplifiers apply]
Gap: [what's missing or could be stronger]
#### 4. Liking β [Rating]
Evidence: [specific quotes or elements from the content]
Amplifiers active: [list which amplifiers apply]
Gap: [what's missing or could be stronger]
#### 5. Authority β [Rating]
Evidence: [specific quotes or elements from the content]
Amplifiers active: [list which amplifiers apply]
Gap: [what's missing or could be stronger]
#### 6. Scarcity β [Rating]
Evidence: [specific quotes or elements from the content]
Amplifiers active: [list which amplifiers apply]
Gap: [what's missing or could be stronger]
Top 3 Improvement Opportunities
#### Opportunity 1: [Principle Name]
Why this has high impact: [mechanism explanation]
Current state: [quote or "absent"]
Recommended change:
> [exact copy to add or replace]
Placement: [where in the content]
#### Opportunity 2: [Principle Name]
Why this has high impact: [mechanism explanation]
Current state: [quote or "absent"]
Recommended change:
> [exact copy to add or replace]
Placement: [where in the content]
#### Opportunity 3: [Principle Name]
Why this has high impact: [mechanism explanation]
Current state: [quote or "absent"]
Recommended change:
> [exact copy to add or replace]
Placement: [where in the content]
Summary
[2-3 sentence overall assessment: what's working, what's the biggest gap, what to do first]
Key Principles
Examples
Scenario: SaaS signup page audit Trigger: "Here's our landing page β why isn't it converting better?" Process: Agent reads the full page copy. Reciprocity: Missing β page leads immediately with pricing and features, no value-first gift. Commitment: Weak β has a CTA but no micro-commitments (no quiz, no "see if you qualify" step). Social Proof: Strong β has customer logos, testimonials with results, user counts. Liking: Weak β corporate tone, no shared struggles, no warmth. Authority: Strong β founders cited in press, credentials listed. Scarcity: Missing β no deadline or limited access signal. Output: Score 8/18. Top 3 opportunities: (1) Add a free tool or resource offer above the fold for reciprocity β include specific copy for a "free audit" widget. (2) Add a micro-commitment step before the main CTA β "See if [Product] is right for you" quiz. (3) Add a "beta cohort closing Friday" deadline with demand-driven explanation.
Scenario: Cold outreach email audit Trigger: "My open rates are fine but replies are terrible β can you audit this email?" Process: Agent reads the email. Reciprocity: Weak β mentions a case study but doesn't lead with it as a gift. Commitment: Missing β no small ask, jumps straight to "schedule a call." Social Proof: Missing β no evidence of results, no similar clients. Liking: Weak β template-feeling language, no demonstrated research into recipient. Authority: Strong β mentions publications and company size. Scarcity: Missing. Output: Score 5/18. The email establishes authority (who they are) but fails to give value first, build connection, or reduce the friction of a large first ask. Top opportunity: Lead with a specific insight about the recipient's business (liking through demonstrated attention), offer it as a free observation (reciprocity), then ask for a smaller commitment than a call β "Would it be useful if I sent you the full analysis?" builds commitment before scheduling.
Scenario: B2B proposal document audit Trigger: "I keep losing deals at proposal stage β audit this proposal." Process: Agent reads the proposal. Reciprocity: Strong β includes a free discovery findings section. Commitment: Strong β proposal references agreements made in discovery call ("As you said you needed..."). Social Proof: Weak β includes two testimonials but from different industries. Liking: Strong β personalized language, references shared goals. Authority: Strong β case studies with detailed results. Scarcity: Counterproductive β says "this offer expires in 30 days" but the timeline feels arbitrary and manufactured. Output: Score 13/18. Strongest proposal areas are authority, liking, and commitment. The scarcity claim is backfiring β it reads as a pressure tactic rather than a genuine constraint, which undermines the trust built elsewhere. Fix: Replace arbitrary deadline with demand-driven scarcity ("We can only take on 2 new clients this quarter due to onboarding capacity") and fix social proof by adding a case study from the prospect's industry.
References
License
This skill is licensed under CC-BY-SA-4.0. Source: BookForge β Influence Psychology Of Persuasion by Unknown.
Related BookForge Skills
This skill is standalone. Browse more BookForge skills: bookforge-skills
β‘ When to Use
π‘ Examples
Scenario: SaaS signup page audit Trigger: "Here's our landing page β why isn't it converting better?" Process: Agent reads the full page copy. Reciprocity: Missing β page leads immediately with pricing and features, no value-first gift. Commitment: Weak β has a CTA but no micro-commitments (no quiz, no "see if you qualify" step). Social Proof: Strong β has customer logos, testimonials with results, user counts. Liking: Weak β corporate tone, no shared struggles, no warmth. Authority: Strong β founders cited in press, credentials listed. Scarcity: Missing β no deadline or limited access signal. Output: Score 8/18. Top 3 opportunities: (1) Add a free tool or resource offer above the fold for reciprocity β include specific copy for a "free audit" widget. (2) Add a micro-commitment step before the main CTA β "See if [Product] is right for you" quiz. (3) Add a "beta cohort closing Friday" deadline with demand-driven explanation.
Scenario: Cold outreach email audit Trigger: "My open rates are fine but replies are terrible β can you audit this email?" Process: Agent reads the email. Reciprocity: Weak β mentions a case study but doesn't lead with it as a gift. Commitment: Missing β no small ask, jumps straight to "schedule a call." Social Proof: Missing β no evidence of results, no similar clients. Liking: Weak β template-feeling language, no demonstrated research into recipient. Authority: Strong β mentions publications and company size. Scarcity: Missing. Output: Score 5/18. The email establishes authority (who they are) but fails to give value first, build connection, or reduce the friction of a large first ask. Top opportunity: Lead with a specific insight about the recipient's business (liking through demonstrated attention), offer it as a free observation (reciprocity), then ask for a smaller commitment than a call β "Would it be useful if I sent you the full analysis?" builds commitment before scheduling.
Scenario: B2B proposal document audit Trigger: "I keep losing deals at proposal stage β audit this proposal." Process: Agent reads the proposal. Reciprocity: Strong β includes a free discovery findings section. Commitment: Strong β proposal references agreements made in discovery call ("As you said you needed..."). Social Proof: Weak β includes two testimonials but from different industries. Liking: Strong β personalized language, references shared goals. Authority: Strong β case studies with detailed results. Scarcity: Counterproductive β says "this offer expires in 30 days" but the timeline feels arbitrary and manufactured. Output: Score 13/18. Strongest proposal areas are authority, liking, and commitment. The scarcity claim is backfiring β it reads as a pressure tactic rather than a genuine constraint, which undermines the trust built elsewhere. Fix: Replace arbitrary deadline with demand-driven scarcity ("We can only take on 2 new clients this quarter due to onboarding capacity") and fix social proof by adding a case study from the prospect's industry.