content-engine

What this skill does

# Content Engine

## When to Use This Skill

Activate this module when the user's request involves any of the following:

- **SEO Content**: Blog posts, pillar pages, topic clusters, or any content optimized for search
- **Ad Copy**: Headlines, descriptions, and creative for any paid platform (Google, Meta, LinkedIn, TikTok, etc.)
- **Email Marketing**: Email sequences, drip campaigns, newsletters, transactional emails, or cold outreach
- **Social Media Content**: Organic posts, captions, hashtag strategy, or content calendars for social platforms
- **Landing Pages**: Conversion-focused page copy, hero sections, CTAs, and page structure
- **Content Calendars**: Editorial planning, content scheduling, and theme mapping
- **Brand Voice**: Voice and tone guidelines, messaging frameworks, and brand language systems
- **Content Decay Detection**: Identifying content that has lost rankings, traffic, or relevance over time
- **AI Content Quality Management**: Ensuring AI-generated content meets quality, originality, and brand standards
- **Accessibility Compliance**: Making content accessible (WCAG standards, alt text, readability, screen reader compatibility)
- **Multilingual/Localization**: Adapting content for different languages, cultures, and regional markets
- **Email Infrastructure**: Deliverability, authentication (SPF, DKIM, DMARC), domain warming, and sender reputation

**Trigger phrases**: "write a blog post," "ad copy," "email sequence," "social media calendar," "landing page," "content calendar," "brand voice," "content audit," "content decay," "AI content," "accessibility," "translate," "localize," "email deliverability," "subject line," "headline," "CTA," "newsletter"

## Brand Context (Auto-Applied)

Before producing any marketing output from this module:

1. **Check session context** — The active brand summary was output at session start. Use the brand name, industry, voice settings, channels, goals, compliance, and competitors shown there.
2. **If you need the full profile**, read: `~/.claude-marketing/brands/{slug}/profile.json`
3. **Apply brand voice** — Formality, energy, humor, authority levels must shape all content tone and word choices
4. **Check compliance** — Auto-apply rules for brand's target_markets and industry using `skills/context-engine/compliance-rules.md`
5. **Reference industry benchmarks** — Consult `skills/context-engine/industry-profiles.md` for the brand's industry
6. **Use platform specs** — Reference `skills/context-engine/platform-specs.md` for character limits and format requirements
7. **Check campaign history** — Run `python campaign-tracker.py --brand {slug} --action list-campaigns` before planning new work
8. **If no brand exists**, say: "No brand profile found. Use /digital-marketing-pro:brand-setup to create one, or I can proceed with general best practices."
9. **Check brand guidelines** — If `~/.claude-marketing/brands/{slug}/guidelines/_manifest.json` exists, load and enforce: `restrictions.md` for banned words, restricted claims, and mandatory disclaimers; `channel-styles.md` for channel-specific tone overrides (may differ from base voice); `messaging.md` for approved key messages, taglines, and positioning language; `voice-and-tone.md` for detailed voice rules beyond the 4 numeric scores. If producing content for a specific channel, channel style rules take precedence over base voice settings.

Do not ask the user for information that already exists in their brand profile.

## Required Context

Before executing content work, gather:

1. **Content Type**: Which specific content format is needed?
2. **Audience**: Who is this content for? (Link to personas from Audience Intelligence if available)
3. **Objective**: What should this content achieve? (Traffic, conversions, engagement, education, retention)
4. **Brand Voice**: Does a brand voice guide exist? What is the tone? (Professional, casual, authoritative, playful, etc.)
5. **Keywords/Topics**: For SEO content — target keywords, search intent, and competitive landscape
6. **Platform**: Where will this content live? (Platform-specific requirements matter)
7. **Funnel Stage**: Where does this content fit in the customer journey?
8. **Existing Content**: What related content already exists? (Avoid cannibalization)
9. **Constraints**: Word count limits, character limits, regulatory disclaimers, brand guidelines
10. **Performance Benchmarks**: What does success look like for this content type?

For quick requests (e.g., "write me a LinkedIn post"), infer reasonable defaults and deliver immediately. For strategic content work, gather full context.

## Capabilities

- **SEO Content Creation**: Keyword-optimized blog posts, pillar pages, topic cluster design, meta titles/descriptions, internal linking strategy, and featured snippet optimization
- **Ad Copy (All Platforms)**: Google Ads (RSAs, headlines, descriptions), Meta Ads (primary text, headlines, descriptions), LinkedIn Ads, TikTok Ads, Twitter/X Ads — platform-specific formats and character limits
- **Email Sequences**: Welcome sequences, nurture drips, cart abandonment, re-engagement, onboarding, upsell/cross-sell, and win-back sequences with subject lines, preview text, body copy, and CTAs
- **Social Content**: Platform-native content for LinkedIn, Twitter/X, Instagram, TikTok, Facebook, YouTube, Pinterest — including captions, hashtags, hooks, and post structure
- **Landing Page Copy**: Hero headline/subhead, value proposition blocks, social proof, feature/benefit sections, FAQ, and CTA optimization
- **Content Calendars**: Editorial calendars with theme mapping, content pillars, publishing cadence, and channel distribution plans
- **Brand Voice System**: Voice attributes, tone spectrum (how voice adapts by context), vocabulary guidelines, do/don't examples, and brand-specific terminology
- **Content Decay Detection**: Methodology for identifying declining content by traffic, rankings, engagement, and freshness — with refresh prioritization
- **AI Content Quality Management**: Quality checklist for AI-generated content, originality verification approach, brand alignment review, fact-checking protocol, and human-in-the-loop guidelines
- **Accessibility Compliance**: WCAG 2.1 AA content guidelines, alt text writing, readability scoring, heading structure, link text, color contrast guidance, and screen reader optimization
- **Multilingual/Localization**: Translation-ready content structuring, cultural adaptation framework, locale-specific messaging guidelines, and RTL language considerations
- **Email Infrastructure**: SPF/DKIM/DMARC setup guidance, domain warming schedules, list hygiene practices, deliverability monitoring, and sender reputation management

## Process

**Primary Workflow: Content Creation**

1. **Content Strategy Alignment**
   - Confirm the content type, audience, objective, and funnel stage
   - Check for existing content that may overlap (prevent cannibalization)
   - Identify the core message and key takeaway
   - Select the appropriate content framework for the task

2. **Research & Preparation**
   - For SEO content: Analyze target keyword, search intent, SERP features, and top-ranking content
   - For ad copy: Review platform specs, competitor ads, and audience pain points
   - For email: Identify the sequence trigger, desired action, and subscriber segment
   - For social: Check platform trends, optimal formats, and audience behavior patterns
   - For landing pages: Identify the traffic source, visitor intent, and conversion goal

3. **Content Creation**
   - Apply the brand voice guidelines (or establish them if none exist)
   - Write to the specific format requirements (character limits, structure, platform norms)
   - Build in persuasion architecture:
     - **Attention**: Hook/headline that stops the scroll or earns the click
     - **Interest**: Problem-aware framing that demonstrates understanding
     - **Desire**: Solution positioning with clear benefits and social p