Claude-Skills content-production

install
source · Clone the upstream repo
git clone https://github.com/borghei/Claude-Skills
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/borghei/Claude-Skills "$T" && mkdir -p ~/.claude/skills && cp -r "$T/marketing/content-production" ~/.claude/skills/borghei-claude-skills-content-production && rm -rf "$T"
manifest: marketing/content-production/SKILL.md
source content

Content Production

The execution engine for content — taking topics from blank page to published, optimized, and distributed.


Table of Contents


Keywords

content production, blog writing, article drafting, content pipeline, editorial workflow, content operations, content calendar, content brief, SEO content, content optimization, readability, internal linking, meta tags, content repurposing, content at scale, editorial calendar, content quality, publishing workflow, long-form content, content management


Quick Start

Write a Blog Post End-to-End

  1. Research: analyze top 5 ranking pieces for the target keyword
  2. Brief: define keyword targets, angle, audience, and H2 structure
  3. Draft: write with outline-first approach, leading each section with its main point
  4. Optimize: SEO pass, readability pass, structure audit, meta tags
  5. Validate: run the quality gate checklist before publishing

Set Up Content Operations

  1. Define content pillars aligned with business goals
  2. Build an editorial calendar with 4-6 weeks of planned content
  3. Establish the production workflow (brief > draft > edit > optimize > publish)
  4. Set up repurposing workflow to multiply each piece across channels
  5. Define quality gates that every piece must pass before publishing

Core Workflows

Workflow 1: Research and Brief

Step 1: Competitive Content Analysis

Before writing, understand what already ranks for your target keyword:

  1. Identify the top 5-10 ranking pieces
  2. Map their angles and formats:
URLFormatWord CountKey AngleWhat's Missing
[URL 1]How-to guide2,400Step-by-step technicalNo real-world examples
[URL 2]Listicle1,800Tools comparisonOutdated, 2023 data
[URL 3]Expert roundup3,100Multiple perspectivesNo actionable framework
  1. Identify the content gap: what does nobody cover well?
  2. Verify search intent:
SERP PatternIntentWhat to Write
"What is / How to" dominateInformationalComprehensive guide or explainer
Product pages, reviewsCommercialComparison or buyer's guide
Forum results (Reddit, Quora)DiscoveryOpinionated piece with real perspective
News, recent articlesTrendingTimely take with unique angle

Step 2: Source Gathering

Collect 3-5 credible, citable sources before drafting:

  • Original research (studies, surveys, published reports)
  • Official documentation or industry standards
  • Expert quotes with full attribution
  • Data with specific numbers (not vague claims)

Rule: If you cannot cite a specific number, do not make a vague claim.

Step 3: Produce the Content Brief

## Content Brief

### Target
- Primary keyword: [keyword] (volume: [X], difficulty: [X])
- Secondary keywords: [keyword 1], [keyword 2], [keyword 3]
- Search intent: [Informational / Commercial / Transactional]

### Audience
- Reader profile: [Who they are and what they know]
- Job-to-be-done: [What problem they are solving right now]
- Awareness level: [Unaware / Problem-aware / Solution-aware]

### Angle
- Unique perspective: [What makes this piece different]
- Core argument: [The single thesis of this piece]
- Key claims to prove: [3-5 specific claims with supporting evidence]

### Structure
- H1: [Working title]
- H2: [Section 1]
- H2: [Section 2]
- H2: [Section 3]
- H2: [Section 4]
- H2: [Conclusion / Next Steps]

### Requirements
- Target word count: [X]
- Internal links to include: [List existing pages to link to]
- Competitive pieces to beat: [Top 3 URLs to outperform]
- CTA: [What action should the reader take]

Workflow 2: Drafting

Step 1: Build the Outline

Before writing prose, create the header skeleton:

  • H1 that includes the keyword and creates curiosity
  • 4-7 H2 sections in logical progression
  • H3s only when a section genuinely needs subdivision
  • Conclusion with CTA

Step 2: Write the Introduction

The intro has one job: make the reader believe this piece answers their question.

Formula:

  1. Name the problem or situation the reader is in (1 sentence)
  2. Name what this piece does about it (1 sentence)
  3. Establish credibility if relevant (1 sentence, optional)

What to avoid:

  • "In today's digital landscape..." (everyone does this)
  • Starting with a question unless it is genuinely sharp
  • Three sentences of context before reaching the point

Step 3: Write Section by Section

For each H2:

  1. State the main point in the first sentence
  2. Prove it with an example, statistic, or comparison
  3. Provide one actionable takeaway before moving to the next section
  4. Use transitional phrases to connect sections naturally

Step 4: Write the Conclusion

Three elements:

  1. Summary of core argument (1-2 sentences, not a repeat of the intro)
  2. The single most important next step
  3. CTA aligned with the content goal

Workflow 3: Optimization Pipeline

Run these passes in order on every draft:

Pass 1: SEO Optimization

  • Title tag: contains primary keyword, under 60 characters, curiosity-driving
  • H1: different from title tag, keyword-rich, reads naturally
  • H2s: at least 2-3 contain secondary keywords or related phrases
  • First paragraph: primary keyword appears in first 100 words
  • Keyword density: primary keyword appears naturally 3-5 times (not stuffed)
  • Image alt text: descriptive, includes keyword where natural
  • URL slug: short, keyword-first, no stop words
  • Internal links: 2-4 minimum, linking to and from related content
  • External links: 1-3 to authoritative sources

Pass 2: Readability

  • Average sentence length: 15-20 words with variation
  • No paragraph exceeds 4 sentences
  • Active voice used in 80%+ of sentences
  • Jargon explained on first use for non-expert audiences
  • At least one visual element (image, table, diagram) per 500 words
  • Subheadings visible every 200-300 words
  • Readability score target: 60-70 (Flesch-Kincaid)

Pass 3: Structure Audit

  • Intro delivers on the headline's promise
  • Every H2 earns its place (cut sections that add no value)
  • At least 2 concrete examples or illustrations
  • Conclusion feels earned, not padded
  • Content flow follows logical progression
  • No orphan sections that could be merged

Pass 4: Meta Content

  • Meta description: 150-160 characters, includes keyword, ends with hook
  • OG title: optimized for social sharing (can differ from meta title)
  • OG description: optimized for social click-through
  • Canonical URL: set correctly
  • Schema markup: Article schema at minimum

Editorial Calendar Management

Calendar Structure

WeekMondayWednesdayFriday
1[Pillar topic A][Supporting topic B][Social repurpose]
2[Pillar topic C][Guest/collab piece][Update old post]
3[Pillar topic A][Supporting topic D][Social repurpose]
4[Data/research piece][Supporting topic E][Roundup/compilation]

Content Types by Frequency

TypeFrequencyPurpose
Pillar posts (2,000+ words)2x/monthAuthority building, SEO ranking
Supporting posts (800-1,500 words)2-4x/monthTopic cluster depth, internal linking
Update/refresh existing posts2x/monthMaintain ranking, improve performance
Data/research pieces1x/monthBacklink attraction, original insights
Guest/collaboration1x/monthAudience expansion, backlinks

Production Timeline

StageOwnerDurationDeadline Relative to Publish
Brief creationStrategist1 dayPublish - 14 days
Research and outlineWriter2 daysPublish - 12 days
First draftWriter3 daysPublish - 9 days
Editorial reviewEditor2 daysPublish - 7 days
RevisionsWriter1 dayPublish - 5 days
SEO optimizationSEO lead1 dayPublish - 4 days
Final reviewEditor1 dayPublish - 3 days
Staging and QAOperations1 dayPublish - 2 days
PublishOperationsPublish day

Content Repurposing System

One Piece, Many Formats

Every pillar content piece should produce 5-8 derivative pieces:

SourceDerivativePlatformEffort
Blog postKey insight threadTwitter/XLow
Blog postCarousel of main pointsLinkedInMedium
Blog postShort-form video summaryTikTok/ReelsMedium
Blog postNewsletter sectionEmailLow
Blog postSlide deckSlideShare/LinkedInMedium
Blog postPodcast discussion topicPodcastLow
Blog postInfographicPinterest/BlogHigh
Blog postFAQ page contentWebsiteLow

Repurposing Workflow

  1. Publish the pillar piece — Let it index and get initial traction
  2. Extract 3-5 key insights — Each insight becomes a standalone social piece
  3. Adapt format per platform — Not copy-paste; reformat for each platform's norms
  4. Schedule distribution — Spread across 1-2 weeks after publication
  5. Cross-link everything — Social pieces link back to the pillar content
  6. Track performance — Identify which derivative formats drive the most traffic back

Evergreen Refresh Cycle

For high-performing content:

  • Review quarterly for accuracy and relevance
  • Update statistics and data points annually
  • Refresh publish date after significant updates
  • Re-promote refreshed content through social and email
  • Add new internal links as related content is published

Quality Gates

Pre-Publish Checklist

Every piece must pass these gates before publishing:

Content Quality:

  • Core thesis is stated clearly in the first 200 words
  • Every factual claim has a source or is labeled as opinion
  • At least one image, table, or visual element
  • Introduction does not start with a cliche
  • Word count is within 10% of target
  • No AI-sounding patterns (run Content Humanizer audit if uncertain)

SEO Quality:

  • Primary keyword in title, H1, first 100 words, and 2+ H2s
  • Meta title under 60 characters with keyword
  • Meta description 150-160 characters with keyword and hook
  • All images have descriptive alt text
  • 2-4 internal links present and functional
  • URL slug is clean and keyword-first

Technical Quality:

  • All links verified and functional
  • Images optimized for web (compressed, appropriate dimensions)
  • Mobile rendering verified
  • Schema markup implemented
  • Canonical URL set
  • OG tags configured for social sharing

Editorial Quality:

  • Spelling and grammar checked
  • Consistent formatting throughout
  • Heading hierarchy maintained (H1 > H2 > H3, no skips)
  • Consistent voice and tone from start to finish
  • CTA present and aligned with content goal

Best Practices

  1. Brief first, always — Never start writing without a brief. Even a 5-minute brief prevents 2 hours of rewriting.

  2. One angle per piece — A piece that tries to be a how-to, a comparison, and an opinion piece fails at all three. Pick one angle.

  3. Front-load value — The reader should get something useful in the first 300 words. Do not make them scroll to find the point.

  4. Optimize existing before creating new — Refreshing a post ranked #8 to #3 produces more traffic than a new post starting at #50.

  5. Internal linking is not optional — Every new piece should link to 2-4 existing pieces, and 2-4 existing pieces should be updated to link to the new piece.

  6. Kill your darlings — If a section does not serve the reader or the keyword strategy, cut it. Length without value hurts ranking.

  7. Batch production — Write briefs for 4-6 pieces at once, then draft in batches. Context-switching between briefing and writing reduces quality.

  8. Measure what matters — Track organic traffic, time on page, and conversion rate. Vanity metrics (word count, publishing frequency alone) are misleading.

  9. Repurpose systematically — Every pillar piece should produce 5+ derivative pieces. Build repurposing into the production workflow, not as an afterthought.

  10. Maintain a content debt backlog — Track content that needs updating, broken links, outdated statistics, and missing internal links. Address content debt regularly.


Integration Points

  • Content Strategy — Use for deciding what to write (topics, calendar, pillar structure). Content Production handles the execution.
  • Content Humanizer — Use after drafting when the piece sounds robotic. Run before the SEO optimization pass.
  • AI SEO — Use for optimizing specifically for AI search citation in addition to traditional SEO.
  • Copywriting — Use for landing pages, CTAs, and conversion copy. Content Production handles long-form content.
  • SEO Specialist — Use for technical SEO audits across the content library. Content Production handles per-piece optimization.
  • Social Content — Use for distributing and repurposing content across social platforms.
  • Copy Editing — Use for the editorial review pass within the production pipeline.

Troubleshooting

ProblemLikely CauseFix
Content consistently fails the quality gate checklistBriefs are incomplete or writers do not have enough contextInvest more time in brief creation — include target keyword, angle, audience, H2 structure, and competitive gaps
Published content ranks #15-30 but does not break into top 10Content depth insufficient or missing E-E-A-T signals compared to page 1 resultsAdd original data, expert quotes, experience signals; increase word count to match or exceed top-ranking competitors
Content sounds robotic after AI-assisted draftingAI patterns not caught during editing passesRun Content Humanizer audit before SEO optimization pass; check for filler words, hedging, and structural uniformity
Internal linking neglected on new postsNot built into production workflowAdd "update 2-4 existing posts to link to new content" as a required step in every production checklist
Repurposing never happens despite planningRepurposing treated as afterthought instead of workflow stepBuild repurposing into the production timeline — schedule derivative content in the same editorial calendar
Production bottleneck at editorial review stageSingle editor reviewing all content; no SLA on review turnaroundSet 48-hour review SLA; create self-service checklists writers can run before submitting for review
Content outdated within 6 months of publishingNo refresh cycle establishedSchedule quarterly reviews for all content ranking top 20; update stats, links, and publish dates

Success Criteria

  • Production velocity: Maintaining planned cadence (2-4 pieces/week) with less than 10% schedule slippage
  • Quality gate pass rate: 90%+ of drafts passing the pre-publish quality gate checklist on first or second review
  • SEO optimization score: Average score of 75+ on the four-pass optimization pipeline (SEO, readability, structure, meta)
  • Readability score: Flesch Reading Ease of 60-70 across all published content (appropriate for web audiences)
  • Internal link coverage: Every new piece includes 3-5 internal links, and 3+ existing pieces updated to link back
  • Repurposing multiplier: Each pillar piece produces 5+ derivative pieces across social, email, and other channels
  • Content performance: 60%+ of content published in last 6 months generating organic impressions within 90 days

Scope & Limitations

In scope:

  • Full content production pipeline from brief to publish
  • Competitive research and source gathering for content briefs
  • Drafting methodology (outline-first, section-by-section)
  • Four-pass optimization pipeline (SEO, readability, structure, meta)
  • Editorial calendar management and production timelines
  • Content repurposing system across channels
  • Quality gates and pre-publish checklists

Out of scope:

  • Content strategy and topic selection (use Content Strategy)
  • AI content humanization (use Content Humanizer)
  • Detailed copy editing (use Copy Editing)
  • Technical SEO audits (use SEO Specialist)
  • Social media platform management (use Social Content)
  • Design and visual content creation

Known limitations:

  • 60% of marketing teams now use AI in content workflows (2026 data) — quality control processes must account for AI-assisted drafting
  • Production timelines assume dedicated writer and editor roles; solo operators need adjusted timelines
  • Content performance measurement requires Google Search Console and analytics access
  • Repurposing effectiveness varies by platform — not all derivative formats will perform equally

Scripts

# Score content readability with detailed metrics
python scripts/readability_scorer.py article.md --json

# Generate a content brief from keyword research
python scripts/content_brief_generator.py --keyword "cloud cost optimization" --json

# Analyze headline options for a new piece
python scripts/headline_analyzer.py --headlines headlines.txt --json