Content

---
name: content
description: "Content operations: editorial calendar, marketing, publishing, social media management."
user-invocable: true
allowed-tools:
  - Read
  - Write
  - Edit
  - Bash
  - Grep
  - Glob
  - WebFetch
routing:
  force_route: false
  not_for: "prose voice and style (use writing), code documentation (use docs-sync-checker)"
  triggers:
    - "editorial calendar"
    - "content pipeline"
    - "content schedule"
    - "marketing"
    - "SEO"
    - "campaign"
    - "email sequence"
    - "outline post"
    - "pre-publish check"
    - "upload to wordpress"
    - "wordpress draft"
    - "post to X"
    - "tweet this"
    - "post tweet"
    - "read Bluesky"
    - "Bluesky feed"
    - "moderate Reddit"
    - "modqueue"
    - "headline"
    - "content strategy"
    - "audit links"
    - "audit images"
    - "batch edit posts"
    - "repurpose this"
    - "news collection"
  category: content
  pairs_with:
    - writing
    - workflow
---

# Content Skill

Six modes: **Calendar** (editorial pipeline), **Marketing** (SEO, campaigns,
email, competitive), **Publish** (outline, pre-publish, SEO, audits, WordPress),
**Social-X** (X/Twitter posts and threads), **Social-Bluesky** (public feed
reading), **Social-Reddit** (moderation). Classify the request and follow the
matching section.

## Mode Selection

| Mode | Signals |
|------|---------|
| **Calendar** | editorial calendar, content pipeline, ideas, scheduling, topics, headlines, news, series, repurpose |
| **Marketing** | SEO audit, campaign, email sequence, content strategy, competitive analysis, brand review, performance |
| **Publish** | outline post, pre-publish check, SEO optimize, batch edit, audit links, audit images, taxonomy, WordPress upload |
| **Social-X** | post to X, tweet, thread, X API |
| **Social-Bluesky** | read Bluesky, Bluesky feed, search Bluesky |
| **Social-Reddit** | moderate Reddit, modqueue, reports |

---

## Calendar Mode

Manage editorial content through 6 pipeline stages: Ideas, Outlined, Drafted,
Editing, Ready, Published. All state lives in a single `content-calendar.md`
file.

### Workflow

1. **READ** -- Load and parse `content-calendar.md`. Validate all sections exist. Do not trust memory; always re-read the actual file.
2. **EXECUTE** -- Perform the requested operation:
   - **View**: count per stage, upcoming scheduled (14 days), in-progress, recent publications (30 days). Flag stuck content (14+ days in one stage).
   - **Add idea**: check for duplicate titles (case-insensitive), append to Ideas.
   - **Move**: forward only through defined sequence (Ideas -> Outlined -> Drafted -> Editing -> Ready -> Published). Record `YYYY-MM-DD` timestamp at each transition.
   - **Schedule**: set date on Ready items. Date must be today or future.
   - **Archive**: move Published entries older than current month to Historical sections.
3. **WRITE** -- Persist changes, re-read file to verify.

### Calendar Sub-modes

| Request | Load |
|---------|------|
| Topic brainstorming, idea generation | `references/topic-brainstormer.md` |
| Headlines, title generation | `references/headlines.md` |
| Series planning, multi-part content | `references/series-planner.md` |
| Content repurposing, platform variants | `references/content-engine.md` |
| News collection, item qualification | `references/news-collection.md` |

---

## Marketing Mode

Seven sub-modes. Always load `references/llm-marketing-failure-modes.md`
alongside mode-specific references for detection heuristics against generic
copy, keyword stuffing, fabricated metrics.

| Sub-mode | Signals | Framework | Load |
|----------|---------|-----------|------|
| SEO_AUDIT | SEO audit, keywords, content gaps, technical SEO | RESEARCH -> AUDIT -> PRIORITIZE | `references/seo-audit.md` |
| CAMPAIGN | Campaign plan, product launch, lead gen, budget | BRIEF -> PLAN -> CALENDAR | `references/campaign-planning.md` |
| CONTENT | Content strategy, editorial calendar, funnel mapping | AUDIT -> PLAN -> DELIVER | `references/content-strategy.md` |
| EMAIL | Email sequence, drip campaign, nurture flow | SEQUENCE -> DRAFT -> AUTOMATE | `references/email-sequences.md` |
| COMPETITIVE | Competitor research, battlecard, positioning | RESEARCH -> COMPARE -> POSITION | `references/seo-audit.md` + `references/campaign-planning.md` |
| BRAND | Brand review, voice check, messaging consistency | AUDIT -> EVALUATE -> RECOMMEND | `references/content-strategy.md` |
| PERFORMANCE | Marketing report, campaign results, ROI | GATHER -> ANALYZE -> REPORT | `references/campaign-planning.md` |

### SEO Audit Quick Steps

1. Gather: URL/domain, audit type, target keywords, competitors (identify 2-3 via web search if not provided).
2. Keyword research: classify by intent (informational, navigational, commercial, transactional). Assess difficulty and opportunity.
3. On-page audit: title tags, meta descriptions, H1/H2, keyword usage, internal linking, image alt text, URL structure.
4. Technical: page speed, mobile, structured data, crawlability, HTTPS, Core Web Vitals.
5. Content gaps: competitor topic coverage, freshness, thin content, funnel gaps.
6. Output: executive summary, keyword table (15-25), issues table, content gap recommendations, technical checklist, competitor matrix, prioritized action plan.

---

## Publish Mode

Eight sub-modes covering the blog publishing pipeline.

| Sub-mode | Signals | Load |
|----------|---------|------|
| Outline | outline post, blog structure, article outline | `references/outline.md` |
| Pre-publish | pre-publish check, Hugo validation, frontmatter | `references/pre-publish.md` |
| SEO | check SEO, optimize SEO, meta description | `references/seo.md` |
| Batch-edit | batch edit posts, bulk frontmatter, find/replace | `references/batch-edit.md` |
| Link-audit | audit links, broken links, link health | `references/link-audit.md` |
| Image-audit | audit images, alt text, image accessibility | `references/image-audit.md` |
| Taxonomy | audit taxonomy, fix tags, merge categories | `references/taxonomy.md` |
| WordPress | upload to WordPress, create draft, edit post | `references/wordpress-upload.md` |

### Outline Quick Steps

1. Gather: topic, target audience, desired format, word count range, SEO target keyword.
2. Research: check existing coverage, identify gaps, gather supporting data.
3. Structure: working title, hook, thesis, 3-7 sections with sub-points, conclusion CTA.
4. Validate: logical flow, sufficient depth per section, SEO keyword placement plan.

### Pre-publish Quick Steps

1. Check: title, date, slug, description, tags, categories, featured image, author, draft=false.
2. Content: spell check, broken internal links, image paths, code blocks render, meta descriptions.
3. SEO: title tag (<60 chars), meta description (120-160 chars), keyword in H1 and first paragraph.

---

## Social-X Mode

OAuth-authenticated X/Twitter posting via `x-api-poster.py`. 4-phase pipeline
with confirmation gate.

### Workflow

1. **VALIDATE** -- Check credentials: `python3 $HOME/.claude/scripts/x-api-poster.py post --dry-run --text "ping"`. Requires `X_API_KEY`, `X_API_SECRET`, `X_ACCESS_TOKEN`, `X_ACCESS_SECRET`, `X_BEARER_TOKEN`. Read-only ops need only `X_BEARER_TOKEN`.
2. **CONFIRM** -- Show user the exact text. For threads: `python3 $HOME/.claude/scripts/x-api-poster.py thread --dry-run --texts "part 1" "part 2"`. Enforce 280-char limit per tweet. Wait for explicit user confirmation.
3. **POST** -- Execute with `--confirmed` flag: `python3 $HOME/.claude/scripts/x-api-poster.py post --confirmed --text "text"`. For media: `--media /path/to/image.png`.
4. **VERIFY** -- Report tweet URL and rate limit status.

---

## Social-Bluesky Mode

Read public Bluesky feeds via AT Protocol. No auth required.

### Commands

```bash
# Fetch recent posts
python3 ~/.claude/scripts/bluesky_reader.py feed --handle HANDLE --limit 20

# Search posts
python3 ~/.claude/scripts/bluesky_reader.py search --handle HANDLE --query "terms"

# JSON output for pipelines
python3 ~/.claude/scripts/bluesky_reader.py feed --handle HANDLE --json
```

Endpoint: `https://public.api.bsky.app/xrpc/app.bsky.feed.getAuthorFeed`. Limit: 1-100 posts. Search is local keyword filter (all words must appear, case-insensitive).

---

## Social-Reddit Mode

Reddit moderation via PRAW. Three modes:

| Mode | Command | Behavior |
|------|---------|----------|
| Interactive | invoke directly | Fetch, classify, present, confirm actions |
| Auto | `/loop 10m /reddit-moderate --auto` | Auto-action high-confidence, flag rest |
| Dry-run | `--dry-run` | Show recommendations without acting |

### Workflow

1. **FETCH** -- `python3 scripts/reddit-moderate/reddit-mod.py queue --json --limit 25 | python3 scripts/reddit-moderate/reddit-mod.py classify`. Loads subreddit context from `reddit-data/{subreddit}/`.
2. **CLASSIFY** -- Fill `classification`, `confidence`, and `reasoning` for each item using the assembled prompt.
3. **PRESENT** -- Group by confidence tier (high/medium/low). Show: title, author, report reason, classification, action, reasoning.
4. **ACT** -- Execute confirmed actions: `python3 scripts/reddit-moderate/reddit-mod.py action --item-id ID --action approve|remove|spam`.

---

## Deep References

Load when the task needs detailed patterns, specifications, or examples.

### Calendar

| Signal | Reference |
|--------|-----------|
| Pipeline stage definitions, transitions | `references/pipeline-stages.md` |
| Calendar file format, sections | `references/calendar-format.md` |
| Operation execution details | `references/operations.md` |
| Pipeline health, velocity metrics | `references/metrics.md` |
| Calendar error recovery | `references/error-handling.md` |

### Marketing

| Signal | Reference |
|--------|-----------|
| SEO audit methodology | `references/seo-audit.md` |
| Campaign planning, budget | `references/campaign-planning.md` |
| Content strategy, frameworks | `references/content-strategy.md` |
| Email sequences, drip campaigns | `references/email-sequences.md` |
| LLM marketing failure modes | `references/llm-marketing-failure-modes.md` |

### Publish

| Signal | Reference |
|--------|-----------|
| Blog outline methodology | `references/outline.md` |
| Pre-publish Hugo checklist | `references/pre-publish.md` |
| Post-level SEO | `references/seo.md` |
| Batch editing methodology | `references/batch-edit.md` |
| Link health scanning | `references/link-audit.md` |
| Image audit, alt text | `references/image-audit.md` |
| Taxonomy management | `references/taxonomy.md` |
| WordPress API upload | `references/wordpress-upload.md` |

### Social

| Signal | Reference |
|--------|-----------|
| X API details | `references/x-api.md` |
| AT Protocol endpoints | `references/at-protocol-api.md` |
| AT Protocol troubleshooting | `references/at-protocol-preferred-patterns.md` |
| Reddit classification categories | `references/classification-prompt.md` |
| Reddit script commands | `references/script-commands.md` |

## Scripts

| Domain | Script | Location |
|--------|--------|----------|
| Reddit moderation | `reddit-mod.py` | `scripts/reddit-moderate/reddit-mod.py` |
| Link scanning | `link_scanner.py` | `scripts/publish/link_scanner.py` |
| PageSpeed | `pagespeed.py` | `scripts/publish/pagespeed.py` |
| WordPress upload | `wordpress-upload.py` | `scripts/publish/wordpress-upload.py` |
| WordPress edit | `wordpress-edit-post.py` | `scripts/publish/wordpress-edit-post.py` |
| WordPress media | `wordpress-media-upload.py` | `scripts/publish/wordpress-media-upload.py` |
| X API poster | `x-api-poster.py` | `$HOME/.claude/scripts/x-api-poster.py` |
| Bluesky reader | `bluesky_reader.py` | `$HOME/.claude/scripts/bluesky_reader.py` |