content-production

Files (4)

• SKILL.md
• content_brief_generator.py · scripts/
• headline_analyzer.py · scripts/
• readability_scorer.py · scripts/

SKILL.md (first lines)

# Content Production

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

---

## Table of Contents

- [Keywords](#keywords)
- [Quick Start](#quick-start)
- [Core Workflows](#core-workflows)
- [Content Brief Framework](#content-brief-framework)
- [Drafting Methodology](#drafting-methodology)
- [Optimization Pipeline](#optimization-pipeline)
- [Editorial Calendar Management](#editorial-calendar-management)
- [Content Repurposing System](#content-repurposing-system)
- [Quality Gates](#quality-gates)
- [Best Practices](#best-practices)
- [Integration Points](#integration-points)

---

## 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

---

## Clarify First

Before producing the content, settle the inputs below. When one is missing or vague and would change the result, ask about it; when it wouldn't, use a sensible default and say which one you used.

- **Primary keyword & search intent:** the target query and whether it is informational/commercial (drives the brief Target + SEO pass).
- **Unique angle / core thesis:** the one argument this piece makes (one angle per piece; drives the Angle section).
- **Target audience & awareness level:** who reads it and what they already know (sets altitude and the Audience section).
- **Target word count:** comprehensive guide vs. supporting post (drives scope and structure).

Ask about the two or three inputs that matter most for this request, not the whole list. If the user wants a result straight away, produce it and state your assumptions at the top.

## 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:

| URL | Format | Word Count | Key Angle | What's Missing |
|-----|--------|-----------|-----------|----------------|
| [URL 1] | How-to guide | 2,400 | Step-by-step technical | No real-world examples |
| [URL 2] | Listicle | 1,800 | Tools comparison | Outdated, 2023 data |
| [URL 3] | Expert roundup | 3,100 | Multiple perspectives | No actionable framework |

3. Identify the content gap: what does nobody cover well?
4. Verify search intent:

| SERP Pattern | Intent | What to Write |
|-------------|--------|---------------|
| "What is / How to" dominate | Informational | Comprehensive guide or explainer |
| Product pages, reviews | Commercial | Comparison or buyer's guide |
| Forum results (Reddit, Quora) | Discovery | Opinionated piece with real perspective |
| News, recent articles | Trending | Timely 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**

```markdown
## 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]

From borghei/Claude-Skills, MIT.

More from borghei/Claude-Skills