Skill: ncreighton/content-audit-expert (version 1.0.0)

--- name: Automate Content Audits with Google Sheets Analysis & Slack Reporting description: "Analyze and audit content for readability, tone, and sentiment with AI-powered insights. Use when the user needs content improvement recommendations, repurposing strategies, or SEO optimization." version: 1.0.0 homepage: https://github.com/ncreighton/empire-skills metadata: {"openclaw":{"requires":{"env":["OPENAI_API_KEY"],"bins":["curl"]},"os":["macos","linux","win32"],"files":["SKILL.md"],"emoji":"📋"}} --- # Content Audit Expert ## Overview Content Audit Expert is a comprehensive AI-powered analysis tool that evaluates your written content across multiple dimensions—readability, tone, sentiment, SEO performance, and audience engagement potential. Rather than surface-level feedback, this skill provides deep structural analysis and actionable repurposing strategies. This skill is invaluable for content teams, marketers, copywriters, and publishers who need to: - **Maintain consistent brand voice** across multiple channels (WordPress, Medium, LinkedIn, Slack) - **Optimize content for search engines** with keyword analysis and heading structure recommendations - **Identify underperforming assets** in your content library and discover repurposing opportunities - **Improve readability scores** for diverse audience segments - **Detect tone misalignment** before publishing across corporate, marketing, or support channels - **Analyze sentiment patterns** to understand emotional resonance with your target audience Unlike basic grammar checkers, Content Audit Expert leverages advanced NLP analysis to evaluate content holistically—examining narrative structure, keyword density, audience alignment, and conversion potential. It integrates seamlessly with WordPress editorial workflows, Slack publishing pipelines, and Google Drive content repositories. ## Quick Start Try these prompts immediately to see the skill in action: ### Example 1: Blog Post Audit ``` Audit this blog post for content quality: Title: "10 Ways to Boost Your Productivity" "Productivity is important. Everyone wants to be more productive. In this article, we'll discuss 10 ways you can boost your productivity. These methods are proven and effective. Let's start. First, you should wake up early. Waking up early helps you get more done. Second, you should make a to-do list. Lists help you stay organized. Third, you should eliminate distractions. Distractions stop you from working. We recommend using apps like Focus@Will or Forest." Provide readability score, tone analysis, sentiment breakdown, and 3 specific repurposing ideas. ``` ### Example 2: Email Copy Analysis ``` Analyze this email for conversion optimization: Subject: "Check Out Our New Product" Body: "Hi there, we've launched a new product. It's really good. You should check it out. Click here to learn more. Thanks." Include: sentiment analysis, audience alignment score, CTA effectiveness rating, and specific copy improvements with before/after examples. ``` ### Example 3: Bulk Content Audit ``` Run a content audit across these three pieces and identify cross-promotion opportunities: Article 1 (2,400 words): "The Complete Guide to SEO in 2024" Article 2 (800 words): "5 Common SEO Mistakes" Article 3 (1,200 words): "How to Optimize Your Title Tags" Provide: overlap analysis, unique value propositions for each, repurposing suggestions (social snippets, email sequences, LinkedIn posts), and a content gap report. ``` ## Capabilities ### 1. **Readability Analysis** - Flesch Kincaid Grade Level calculation - Gunning Fog Index evaluation - Sentence length variance detection - Paragraph structure optimization - Passive vs. active voice ratio analysis - Jargon and complexity flagging **Usage Example:** ``` Evaluate readability for a technical white paper aimed at C-suite executives with a target grade level of 10-12. Flag any overly complex passages that exceed 18 words per sentence on average. ``` ### 2. **Tone & Voice Detection** - Brand voice consistency scoring (0-100) - Formal vs. conversational balance measurement - Authority vs. approachability alignment - Professional tone assessment - Personality/character consistency tracking across multiple pieces - Emotional resonance indicators **Usage Example:** ``` Analyze whether this customer support email maintains our brand voice. Our brand voice guidelines: warm, professional, solution-focused, empathetic. Flag any departures from these principles. ``` ### 3. **Sentiment & Emotional Analysis** - Overall sentiment classification (positive, negative, neutral) - Emotion detection (joy, trust, fear, surprise, sadness, disgust, anger, anticipation) - Emotional intensity scoring - Sentiment progression tracking through content - Reader emotional journey mapping **Usage Example:** ``` Sentiment audit: Does this product landing page evoke the right emotions (confidence, excitement, trust) to drive conversions? Map the emotional journey paragraph by paragraph. ``` ### 4. **SEO & Keyword Performance** - Primary and secondary keyword identification - Keyword density analysis with optimization recommendations - Heading structure (H1/H2/H3) evaluation - Meta description effectiveness - Internal linking opportunity detection - Target audience keyword intent alignment **Usage Example:** ``` SEO audit for target keywords: "content marketing," "marketing automation," "content calendar." Evaluate keyword placement, density, and suggest H2/H3 restructuring for better SERP visibility. ``` ### 5. **Content Repurposing Strategy** - Identify evergreen vs. time-sensitive content - Generate 5+ repurposing ideas (social posts, email sequences, videos, infographics, podcasts) - Calculate ROI potential for each repurposing avenue - Suggest format conversions (blog → email series, article → social carousel) - Cross-promotion opportunity mapping - Content fragmentation strategy (break long-form into series) **Usage Example:** ``` Propose 8 ways to repurpose this 2,000-word guide. Include: LinkedIn article snippets, Twitter/X thread outline, email sequence structure, YouTube video outline, podcast talking points, infographic data points, and webinar transcript. ``` ### 6. **Audience Alignment Scoring** - Target persona matching (0-100) - Language difficulty vs. audience reading level - Relevance score to stated audience - Engagement prediction based on demographic research - Value prop clarity for specific personas ### 7. **Competitive Benchmarking** - Compare against industry standard readability scores - Identify unique value propositions vs. competitor content - Content depth analysis (word count, comprehensiveness) - Missing information gaps relative to top-ranking competitors ## Configuration ### Required Environment Variables ```bash # Set your OpenAI API key (required for AI analysis) export OPENAI_API_KEY="sk-..." # Optional: Set preferred temperature for analysis (0.3-0.7 recommended) export AUDIT_TEMPERATURE="0.5" # Optional: Set content analysis depth (basic, standard, comprehensive) export AUDIT_DEPTH="comprehensive" ``` ### Setup Instructions 1. **Install dependencies** (if running locally): ```bash pip install openai python-dotenv textstat ``` 2. **Authenticate with OpenAI**: - Get your API key from https://platform.openai.com/api-keys - Set the `OPENAI_API_KEY` environment variable - Verify access: `curl https://api.openai.com/v1/models -H "Authorization: Bearer $OPENAI_API_KEY"` 3. **Integration Setups**: - **WordPress**: Use the ClawHub WordPress plugin to send content directly from editor - **Google Docs**: Share document, provide link in prompt - **Slack**: Enable ClawHub in your Slack workspace, use `/audit [content]` command - **Email**: Forward content via email or paste directly ### Configuration Options | Option | Default | Description | |--------|---------|-------------| | `AUDIT_DEPTH` | comprehensive | basic, standard, or comprehensive analysis | | `TARGET_AUDIENCE` | general | Specify audience (C-suite, marketers, developers, etc.) | | `CONTENT_FORMAT` | article | article, email, social, whitepaper, case-study | | `BRAND_VOICE_GUIDELINES` | none | Paste your brand voice document for consistency scoring | | `COMPETITOR_URLS` | none | Include URLs for competitive benchmarking | ## Example Outputs ### Sample Readability Report ``` ═══════════════════════════════════════════════════════════════ READABILITY ANALYSIS ═══════════════════════════════════════════════════════════════ Overall Readability Score: 72/100 (Good) Target Grade Level: 9.4 (High School Sophomore) Flesch Kincaid Grade: 10.2 BREAKDOWN: ├─ Sentence Variety: 85/100 ✓ (Range: 8-32 words) ├─ Paragraph Length: 68/100 ⚠ (Avg: 4.2 sentences) ├─ Passive Voice: 15% (Target: <20%) ✓ ├─ Jargon Density: 8% (Acceptable) └─ Word Complexity: 92% common words ✓ TOP RECOMMENDATIONS: 1. Break paragraph 3 into 2 shorter paragraphs (currently 6 sentences) 2. Simplify "leverage" → "use" in line 47 3. Expand paragraph 5 with subheading for structure ``` ### Sample Tone & Sentiment Report ``` ═══════════════════════════════════════════════════════════════ TONE & SENTIMENT ANALYSIS ═══════════════════════════════════════════════════════════════ Overall Sentiment: Positive (78% confidence) Tone Classification: Professional + Conversational (Well-balanced) EMOTIONAL BREAKDOWN: ├─ Trust: 82% (Strong authority signals) ├─ Anticipation: 71% (Forward-looking language) ├─ Joy: 56% (Moderate positivity) ├─ Fear: 12% (Appropriate risk acknowledgment) └─ Surprise: 34% (Some novel insights) SENTIMENT JOURNEY: Paragraph 1-2: Positive (Introduction) → Paragraph 3-5: Neutral (Technical details) → Paragraph 6-7: Positive (Benefits & conclusion) BRAND VOICE ALIGNMENT: 88/100 ✓ Matches "professional, approachable, solution-focused" guidelines ``` ### Sample Repurposing Strategy ``` ═══════════════════════════════════════════════════════════════ CONTENT REPURPOSING OPPORTUNITIES ═══════════════════════════════════════════════════════════════ Original: 1,850-word blog post "Email Marketing Automation" Content Type: Evergreen (85% evergreen score) Recommended Lifespan: 18+ months with minor updates REPURPOSING IDEAS (Ranked by ROI): 1. EMAIL SEQUENCE (Est. Value: $4,200/month) ├─ 5-part welcome series ├─ Segment: Marketing professionals └─ Time to Create: 2 hours 2. LINKEDIN ARTICLE SERIES (Est. Reach: 15K-25K) ├─ 4-part carousel posts ├─ Best Publishing Days: Tue-Thu, 8am └─ Template Provided: Yes 3. SOCIAL CLIPS (Est. Engagement: +340%) ├─ 8x short-form clips (TikTok/Reels) ├─ Hooks: "3 automation mistakes," "Hidden benefit," etc. └─ Video Scripts: Included 4. WEBINAR OUTLINE (Est. Attendees: 200-400) ├─ 45-minute structure with breakout activities ├─ Slides Required: 18-22 └─ Interactive Elements: 4 polls, 2 demos 5. PODCAST EPISODE (Est. Downloads: 1,200+) ├─ Talking Points: Structured outline ├─ Guest Interview Format: 35-45 minutes └─ Show Notes Template: Provided 6. INFOGRAPHIC (Est. Shares: 800+) ├─ Key Data Points: 7 critical statistics ├─ Design Brief: Provided └─ Distribution: LinkedIn, Pinterest, Twitter ``` ## Tips & Best Practices ### 1. **Establish Baseline Metrics** Before making changes, run an audit to establish your content quality baseline. Track these metrics over time: - Average readability score - Sentiment consistency - Brand voice alignment percentage - SEO keyword density This creates accountability and shows improvement ROI to stakeholders. ### 2. **Use Comparative Audits** ``` Audit your top 5 performing pages against your bottom 5. Look for patterns in readability, tone, and sentiment that correlate with engagement. Use findings to improve underperformers. ``` ### 3. **Implement Brand Voice Guidelines** Create a 1-page brand voice document covering: - Tone descriptors (warm, authoritative, playful, etc.) - Vocabulary (preferred terms vs. forbidden jargon) - Sentence structure preference - Common phrases/mantras - Examples of on-brand and off-brand writing Run audits with this document for 95%+ consistency scoring. ### 4. **Audit Before Updating Content** Always audit existing content before revisions. This: - Identifies what's currently working - Prevents inadvertent tone shifts - Shows specific improvement targets - Creates a before/after comparison for stakeholder reporting ### 5. **Leverage Repurposing for Content Multiplication** A single 2,000-word blog post can generate: - 1 email sequence (5-7 emails) - 8-10 social media posts - 1 webinar outline - 1 short video script - 1 podcast talking points outline Multiplies content ROI by 5-8x without starting from scratch. ### 6. **Segment Audits by Content Type** Different content types have different standards: - **Blog posts**: 70+ readability, positive sentiment - **Sales pages**: 60-70 readability (exclusivity), high trust/anticipation - **Support docs**: 75+ readability (clarity), neutral tone - **Email**: 65-75 readability (scannable), warm tone Configure audits for specific content type standards. ### 7. **Monitor Sentiment Drift** If publishing frequently to a channel (newsletter, blog, social), track sentiment patterns: - Avoid 3+ consecutive negative posts - Mix positive, neutral, and aspirational content - Balance problem-focused with solution-focused messaging - Maintain 70%+ positive sentiment overall for brand reputation ### 8. **Use Competitive Benchmarking** Provide competitor URLs for comparative analysis: ``` Audit my article against these top-ranking competitors: [URL 1], [URL 2], [URL 3] Show: word count comparison, keyword frequency comparison, readability score comparison, sentiment comparison, unique value propositions I should emphasize more. ``` ## Safety & Guardrails ### What This Skill WILL Do ✓ Analyze readability, tone, sentiment, and keyword performance ✓ Suggest structural improvements and repurposing strategies ✓ Provide competitive benchmarking and gap analysis ✓ Generate specific, actionable recommendations ✓ Create before/after editing examples ### What This Skill WILL NOT Do ✗ **Not a substitute for subject matter expertise** — The skill analyzes structure and style, not factual accuracy. Always verify claims, statistics, and technical details independently. ✗ **Not a plagiarism detector** — Use Copyscape, Turnitin, or Grammarly's plagiarism checker instead. ✗ **Not for automated publishing** — All recommendations require human review before publishing. The skill flags concerns but doesn't make editorial decisions. ✗ **Not a replacement for editors** — Use for optimization, not as a complete editing solution. Complex rewrites and narrative restructuring still benefit from human editors. ✗ **Not legal or medical content validation** — This skill cannot verify compliance with industry regulations (HIPAA, legal disclaimers, medical claims). Consult domain experts for regulated content. ✗ **Not cultural sensitivity analysis** — While the skill detects tone, it may miss cultural context or offensive implications. Review with subject matter experts familiar with your audience's culture. ### Limitations & Boundaries | Limitation | Workaround | |-----------|-----------| | Works best with 200+ words | Use bulk audits for shorter content; batch multiple pieces | | Doesn't verify citations/facts | Cross-reference claims with fact-checking tools independently | | Brand voice matching requires clear guidelines | Provide detailed brand voice document for accuracy


Security scan verdicts — ClawScan: clean | static analysis: clean | VirusTotal: clean | SkillSpector: clean (LOW)