<!-- Agent: developer | Task: #14 | Session: 2026-03-21 -->

Content Analyzer

Overview

Multi-dimensional content analysis skill that transforms published text into actionable engagement intelligence. The analysis pipeline covers six dimensions: sentiment detection, readability scoring, structural analysis, hook classification, topic identification, and engagement correlation.

Core principle: Content quality is measurable. Every post has structural attributes that correlate with engagement outcomes. This skill quantifies those attributes and tracks them over time.

When to Invoke

Skill({ skill: 'content-analyzer' });

Invoke when:

• Analyzing a published blog post, article, or social media post
• Running a daily content performance audit
• Identifying what makes top-performing content succeed
• Building a content strategy based on historical performance data
• Diagnosing why a post underperformed expectations
• Comparing content attributes across a portfolio of published work

Do NOT invoke for:

• Pre-publication copyediting (use a writing or editing skill instead)
• SEO keyword research without existing content (use seo-optimization)
• Social media scheduling or publishing automation

Six-Dimension Analysis Pipeline

Dimension 1: Sentiment Analysis

Classify the emotional tone of the content across three axes:

Polarity: Positive / Negative / Neutral / Mixed Emotion: Inspiration, Urgency, Curiosity, Empathy, Authority, Humor, Fear Intensity: 1 (subtle) to 5 (intense)

Scoring method:

• Read the full text and identify the dominant emotional register
• Check for tonal shifts (e.g., problem-heavy opening -> optimistic conclusion)
• Score intensity based on word choice strength and punctuation patterns
• Flag mixed sentiment (common in "problem-solution" posts)

Output:

{
  "sentiment": {
    "polarity": "positive",
    "dominantEmotion": "curiosity",
    "intensity": 3,
    "tonalShifts": ["negative->positive at paragraph 4"],
    "emotionBreakdown": {
      "curiosity": 0.45,
      "authority": 0.3,
      "urgency": 0.15,
      "empathy": 0.1
    }
  }
}

Dimension 2: Readability Scoring

Quantify how easy the content is to read and understand:

Metric	Formula / Method	Target Range
Flesch-Kincaid Grade	0.39(words/sentences) + 11.8(syllables/words) - 15.59	Grade 6-9 for general
Average Sentence Length	Total words / total sentences	15-20 words
Vocabulary Complexity	% of words > 3 syllables	< 15%
Paragraph Length	Average words per paragraph	40-80 words
Passive Voice %	Passive constructions / total sentences	< 10%

Output:

{
  "readability": {
    "fleschKincaidGrade": 7.2,
    "avgSentenceLength": 16.4,
    "vocabularyComplexity": 0.11,
    "avgParagraphLength": 58,
    "passiveVoicePercent": 0.06,
    "rating": "GOOD"
  }
}

Dimension 3: Structural Analysis

Evaluate the architectural quality of the content:

Elements to analyze:

• Opening hook: First 1-2 sentences -- what technique is used?
• Section structure: Number of headings, heading hierarchy, section balance
• Visual breaks: Lists, blockquotes, images, code blocks, callouts
• CTA presence: Where CTAs appear, how strong they are, how many
• Closing: How the post ends (summary, CTA, question, cliffhanger)

Hook Classification Taxonomy:

Hook Type	Description	Example Pattern
Question	Opens with a direct question	"Have you ever wondered why...?"
Statistic	Leads with a surprising number	"78% of readers abandon posts after..."
Story	Begins with a narrative or anecdote	"Last Tuesday, I discovered..."
Contrarian	Challenges conventional wisdom	"Everything you know about X is wrong."
Pain Point	Names a specific frustration	"Tired of writing posts nobody reads?"
Bold Claim	Makes a strong, specific assertion	"This framework will triple your output"
How-To Promise	Promises a specific transformation	"How to go from 0 to 10K followers"
Current Event	Ties to a trending topic or recent development	"With the latest Google update..."

Output:

{
  "structure": {
    "hookType": "statistic",
    "hookText": "78% of content marketers...",
    "headingCount": 6,
    "headingHierarchy": "h1->h2->h3 (consistent)",
    "visualBreaks": { "lists": 4, "blockquotes": 1, "images": 2, "codeBlocks": 0 },
    "ctaCount": 2,
    "ctaPositions": ["mid-article", "closing"],
    "ctaStrength": "medium",
    "closingType": "question",
    "wordCount": 1847,
    "estimatedReadTime": "8 min"
  }
}

Dimension 4: Topic Classification

Identify what the content is about and how it fits into topic clusters:

• Primary topic: The main subject (1 topic)
• Secondary topics: Related themes (2-3 topics)
• Keyword density: Top 10 keywords with frequency
• Topic cluster: Which content pillar this belongs to

Output:

{
  "topics": {
    "primary": "content marketing strategy",
    "secondary": ["SEO optimization", "audience engagement"],
    "topKeywords": [
      { "keyword": "content", "count": 24, "density": 0.013 },
      { "keyword": "engagement", "count": 18, "density": 0.01 }
    ],
    "cluster": "content-strategy"
  }
}

Dimension 5: Wording Pattern Analysis

Analyze the specific language choices that drive engagement:

• Power words: Words that trigger emotion (e.g., "discover", "secret", "proven")
• Transition words: Connectors that improve flow (e.g., "however", "specifically")
• Jargon level: Domain-specific terms as % of total vocabulary
• Personal pronouns: "you/your" frequency (reader-focus indicator)
• Action verbs: Active vs passive construction ratio

Output:

{
  "wording": {
    "powerWordCount": 14,
    "powerWordDensity": 0.008,
    "transitionWordCount": 22,
    "jargonLevel": "low",
    "personalPronounDensity": 0.032,
    "actionVerbRatio": 0.78,
    "topPowerWords": ["discover", "proven", "essential", "transform"]
  }
}

Dimension 6: Engagement Correlation

Map content attributes to engagement outcomes (requires engagement data):

Correlation analysis:

For each content attribute (hook type, length, sentiment, topic):
  1. Group posts by attribute value
  2. Calculate average engagement per group
  3. Rank groups by engagement
  4. Identify statistically significant differences

Output:

{
  "engagement": {
    "metrics": {
      "views": 4521,
      "likes": 234,
      "comments": 47,
      "shares": 89,
      "bookmarks": 156,
      "engagementRate": 0.116
    },
    "correlations": {
      "hookType": { "statistic": 1.4, "question": 1.2, "story": 1.0, "howTo": 0.8 },
      "lengthBucket": { "1500-2000": 1.3, "1000-1500": 1.1, "2000+": 0.9, "<1000": 0.7 },
      "sentimentTone": { "curiosity": 1.5, "authority": 1.2, "urgency": 0.9 }
    },
    "confidenceLevel": "medium",
    "sampleSize": 23
  }
}

CLI Integration

Run the analysis via the post-analyzer CLI tool:

# Analyze a single URL
node .claude/tools/cli/post-analyzer.cjs --url "https://example.com/post" --output json

# Analyze from local text file
node .claude/tools/cli/post-analyzer.cjs --file "./content.txt" --output json

# Generate daily report
node .claude/tools/cli/post-analyzer.cjs --url "https://example.com/post" --report daily

Report Generation

After analysis, generate a daily report using the template:

.claude/templates/reports/daily-content-report.md

Output to:

.claude/context/reports/backend/daily-content-report-{YYYY-MM-DD}.md

Historical Data Storage

All analysis results are appended to:

.claude/context/data/content-analytics.json

Schema:

{
  "analyses": [
    {
      "id": "analysis-{timestamp}",
      "url": "https://example.com/post",
      "analyzedAt": "2026-03-21T10:00:00Z",
      "title": "Post Title",
      "sentiment": {},
      "readability": {},
      "structure": {},
      "topics": {},
      "wording": {},
      "engagement": {}
    }
  ],
  "trends": {
    "7day": {},
    "30day": {}
  },
  "lastUpdated": "2026-03-21T10:00:00Z"
}

Iron Laws

1. ALWAYS analyze all six dimensions for every post -- partial analysis produces misleading conclusions.
2. ALWAYS store results in content-analytics.json after every analysis -- trend detection requires complete historical data.
3. NEVER report engagement correlations from fewer than 5 data points -- small samples produce spurious patterns.
4. ALWAYS classify the hook type before reporting engagement drivers -- the hook is the strongest single predictor of click-through performance.
5. NEVER scrape content without respecting rate limits and robots.txt -- getting blocked destroys the analysis pipeline.

Anti-Patterns

Anti-Pattern	Why It Fails	Correct Approach
Analyzing sentiment without readability	Sentiment alone does not explain engagement	Always run all six dimensions together
Reporting "best hook type" from 3 posts	Statistically meaningless; random variation dominates	Require minimum 5 posts per category before drawing conclusions
Ignoring historical baseline	Cannot detect improvement or regression	Always compare against 7-day and 30-day averages
Treating all engagement metrics equally	Comments indicate depth; likes indicate breadth	Weight metrics by type: shares > comments > likes > views for depth
Scraping entire site without URL filtering	Overwhelms analysis with non-article pages	Target only published article URLs, skip navigation/utility pages

Assigned Agents

This skill is used by:

• post-analyzer-agent -- Primary: daily content analysis and reporting
• feedback-synthesizer -- Supporting: when content feedback intersects with customer feedback
• researcher -- Supporting: when content research needs quantitative analysis

Memory Protocol (MANDATORY)

Before starting:

node .claude/lib/memory/memory-search.cjs "content analysis engagement hooks sentiment"

Read .claude/context/memory/learnings.md

Check for:

• Previous content analysis results and patterns
• Known engagement driver correlations
• Historical trend data in content-analytics.json

After completing:

• New content pattern discovered -> .claude/context/memory/learnings.md
• Analysis pipeline issue -> .claude/context/memory/issues.md
• Engagement correlation decision -> .claude/context/memory/decisions.md

ASSUME INTERRUPTION: Your context may reset. If it's not in memory, it didn't happen.