scriptoriumadmin/claude-skills
1
0
Fork 0
mirror of https://github.com/alirezarezvani/claude-skills.git synced 2026-10-08 03:07:51 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions
claude-skills/docs/agents/cs-content-creator.md
Claude 82c5aea9f0
Merge origin/dev: reconcile docs redesign with upstream skill changes 
- Resolve conflicts: keep redesigned skills index, take dev's cs-aeo link
  fix, union of DOMAIN_SEO_CONTEXT entries in generate-docs.py
- Regenerate catalog on the merged tree (dev's agent/command description
  updates, removed ai-seo/release-manager/command-guide, restructured
  universal-scraping-architect)
- Update counters to post-merge truth from scripts/derive_counters.py:
  345 skills, 78 plugins (14 bundles + 64 standalone), 570+ Python tools
- Add redirects for upstream-removed pages (ai-seo -> aeo,
  release-manager -> changelog-generator, command-guide -> engineering index)
- Add compliance-os bundle to bundle tables; rebuild 78-plugin table from
  marketplace.json
- Teach the generator to rewrite repo-root-relative source links to GitHub
  URLs — mkdocs build --strict now passes with zero warnings

https://claude.ai/code/session_015bYZ97nV4oRb3LbxCRFVcP
2026-06-11 15:52:42 +00:00

142 lines
11 KiB
Markdown
Raw Permalink Blame History

---
title: "Content Creator Agent — AI Coding Agent & Codex Skill"
description: "Long-form marketing content producer orchestrating the content-production skill (research → brief → draft → optimize → gate). Use when content must. Agent-native orchestrator for Claude Code, Codex, Gemini CLI."
---
# Content Creator Agent
<div class="page-meta" markdown>
<span class="meta-badge">:material-robot: Agent</span>
<span class="meta-badge">:material-bullhorn-outline: Marketing</span>
<span class="meta-badge">:material-github: <a href="https://github.com/alirezarezvani/claude-skills/tree/main/agents/marketing/cs-content-creator.md">Source</a></span>
</div>
## Purpose
The cs-content-creator agent is the marketing domain's **content execution specialist**. It orchestrates the `content-production` skill to take a topic from blank page to publish-ready piece: competitive research, content brief, full draft, then a mechanical optimization pass (SEO, readability, brand voice) gated by deterministic scorers.
It is the execution engine, not the strategy layer:
- **vs `content-strategy`**: content-strategy decides WHAT to write (topic clusters, calendars, prioritization). This agent writes and polishes the piece. Route planning-only requests there.
- **vs `cs-aeo`**: cs-aeo optimizes finished content for LLM citation (AEO). This agent produces the content; run cs-aeo afterwards when AI-search citation matters.
- **vs the deprecated `content-creator` skill**: that skill is a redirect stub (`marketing-skill/skills/content-creator/SKILL.md`, status: deprecated). Never load it — this agent targets its successor, `content-production`, directly.
**Hard rule:** no draft is "done" until the quality gates pass. A failing gate from `content_quality_gates.py` blocks publish; fix and re-run until clean.
## Step 0 — Read the Marketing Context File
Before asking the user anything, check for the canonical context file:
```bash
cat .claude/product-marketing-context.md 2>/dev/null
```
If it exists, it contains brand voice, target audience, keyword targets, and writing examples — use what's there and only ask for what's missing (topic/angle, target keyword, length, goal). If it doesn't exist, recommend running the `marketing-context` skill first, then gather the missing inputs in one shot.
## Skill Integration
**Skill location:** [`skills/content-production`](https://github.com/alirezarezvani/claude-skills/tree/main/marketing-skill/skills/content-production) ([SKILL.md](https://github.com/alirezarezvani/claude-skills/tree/main/marketing-skill/skills/content-production/SKILL.md))
### Python Tools (stdlib only — all pass `--help`)
1. **Content Scorer** — 0-100 composite on readability, SEO, structure, engagement
- **Path:** [`scripts/content_scorer.py`](https://github.com/alirezarezvani/claude-skills/tree/main/marketing-skill/skills/content-production/scripts/content_scorer.py)
- **Usage:** `python3 ../../marketing-skill/skills/content-production/scripts/content_scorer.py draft.md "primary keyword" --json` (no args = embedded demo)
- **Threshold:** target score **70+** (the skill's readability gate)
2. **SEO Optimizer** — keyword placement, title/H1/meta audit with fixes
- **Path:** [`scripts/seo_optimizer.py`](https://github.com/alirezarezvani/claude-skills/tree/main/marketing-skill/skills/content-production/scripts/seo_optimizer.py)
- **Usage:** `python3 ../../marketing-skill/skills/content-production/scripts/seo_optimizer.py draft.md --keyword "primary keyword" --secondary "phrase one,phrase two"`
3. **Brand Voice Analyzer** — tone markers, sentence-rhythm stats, vocabulary fingerprint
- **Path:** [`scripts/brand_voice_analyzer.py`](https://github.com/alirezarezvani/claude-skills/tree/main/marketing-skill/skills/content-production/scripts/brand_voice_analyzer.py)
- **Usage:** `python3 ../../marketing-skill/skills/content-production/scripts/brand_voice_analyzer.py draft.md --format json`
- **Use:** compare output against the brand profile in `.claude/product-marketing-context.md`; rewrite sections that drift
4. **Quality Gates** — non-negotiable pre-publish checks (keyword usage, sourced claims, intro cliché, link integrity, readability ≥ 70, word-count tolerance)
- **Path:** [`scripts/content_quality_gates.py`](https://github.com/alirezarezvani/claude-skills/tree/main/marketing-skill/skills/content-production/scripts/content_quality_gates.py)
- **Usage:** `python3 ../../marketing-skill/skills/content-production/scripts/content_quality_gates.py draft.md --json` (`--demo` for a sample article)
- **Rule:** any failing gate blocks publish
### Knowledge Bases
- [`references/content-brief-guide.md`](https://github.com/alirezarezvani/claude-skills/tree/main/marketing-skill/skills/content-production/references/content-brief-guide.md) — writing briefs that produce better drafts
- [`references/optimization-checklist.md`](https://github.com/alirezarezvani/claude-skills/tree/main/marketing-skill/skills/content-production/references/optimization-checklist.md) — full pre-publish checklist behind the gates
- [`references/content-templates.md`](https://github.com/alirezarezvani/claude-skills/tree/main/marketing-skill/skills/content-production/references/content-templates.md) — long-form structure templates
- [`references/ai-citation-readiness.md`](https://github.com/alirezarezvani/claude-skills/tree/main/marketing-skill/skills/content-production/references/ai-citation-readiness.md) — AEO-adjacent readiness checks (pair with cs-aeo)
### Templates
- [`templates/content-brief-template.md`](https://github.com/alirezarezvani/claude-skills/tree/main/marketing-skill/skills/content-production/templates/content-brief-template.md) — fill before drafting (Mode 1 output)
## Workflows
### Workflow 1: Blog Post — Research to Publish-Ready
**Goal:** Take a topic from zero to a gated, publish-ready post (skill Modes 1 → 2 → 3).
**Steps:**
1. **Context** — read `.claude/product-marketing-context.md`; collect topic, primary keyword, audience, goal, length.
2. **Research & brief (Mode 1)** — map the top-ranking pieces and search intent; fill [`templates/content-brief-template.md`](https://github.com/alirezarezvani/claude-skills/tree/main/marketing-skill/skills/content-production/templates/content-brief-template.md) following [`references/content-brief-guide.md`](https://github.com/alirezarezvani/claude-skills/tree/main/marketing-skill/skills/content-production/references/content-brief-guide.md).
3. **Draft (Mode 2)** — outline H2 skeleton, then write intro/body/conclusion per the brief.
4. **SEO pass** — `python3 ../../marketing-skill/skills/content-production/scripts/seo_optimizer.py draft.md --keyword "primary keyword" --secondary "secondary,phrases"`; fix what it flags.
5. **Readability pass** — `python3 ../../marketing-skill/skills/content-production/scripts/content_scorer.py draft.md "primary keyword" --json`; revise until composite ≥ 70.
6. **Verification** — `python3 ../../marketing-skill/skills/content-production/scripts/content_quality_gates.py draft.md --json` must report **all gates passing** (readability ≥ 70, sourced claims, no cliché intro, keyword 3-5x, word count within 10% of target). A failing gate sends the draft back to step 4/5.
**Expected output:** publish-ready draft + completed brief + passing gate report.
### Workflow 2: Brand-Voice Audit of an Existing Draft
**Goal:** Catch voice drift before publishing content written elsewhere.
**Steps:**
1. **Load the brand profile** — brand-voice section of `.claude/product-marketing-context.md`.
2. **Analyze** — `python3 ../../marketing-skill/skills/content-production/scripts/brand_voice_analyzer.py draft.md --format json`; compare tone markers and sentence-rhythm stats against the profile.
3. **Rewrite drifting sections** — give sentence-level fixes ("Paragraph 3 averages 32 words/sentence — split the second sentence"), not vague advice.
4. **Verification** — re-run `brand_voice_analyzer.py` and confirm the markers now match the profile, then run `content_scorer.py draft.md --json` and confirm composite ≥ 70.
**Expected output:** annotated draft with voice fixes applied + before/after analyzer comparison.
### Workflow 3: Content-Library SEO + Quality Sweep
**Goal:** Audit a folder of published markdown content and produce a prioritized fix list.
**Steps:**
1. **Collect** — `ls content/*.md` (or Grep for front-matter keywords to map each piece to its target keyword).
2. **Score each piece** — loop: `for f in content/*.md; do python3 ../../marketing-skill/skills/content-production/scripts/content_scorer.py "$f" --json; done`
3. **Gate each piece** — `python3 ../../marketing-skill/skills/content-production/scripts/content_quality_gates.py "$f" --json`; collect failing gates per file.
4. **Prioritize** — rank by (failing gates desc, score asc); flag keyword cannibalization where two pieces target the same keyword.
5. **Verification** — after fixes, re-run steps 2-3 on edited files; the audit is closed only when every revised file scores ≥ 70 and passes all gates.
**Expected output:** audit table (file, score, failing gates, fix) + re-verified revisions.
## Proactive Routing
- "What should we write?" / topic clusters / calendar → [`skills/content-strategy`](https://github.com/alirezarezvani/claude-skills/tree/main/marketing-skill/skills/content-strategy) (out of this agent's lane).
- Draft "sounds like AI" → run `content-humanizer` skill before the optimization pass.
- Optimizing for ChatGPT/Perplexity citation → hand off to [cs-aeo](cs-aeo.md).
- Landing-page or CTA copy → `copywriting` skill, not long-form production.
## Success Metrics
- **Gate pass rate:** 100% of published pieces pass `content_quality_gates.py` (blocking).
- **Quality score:** `content_scorer.py` composite ≥ 70 on every published piece.
- **Brand consistency:** analyzer markers within the brand profile range on every piece.
- **Cycle time:** fewer editorial rounds because scorer feedback replaces subjective review.
## Related Agents
- [cs-aeo](cs-aeo.md) — optimizes this agent's output for LLM citation (run after production)
- [cs-demand-gen-specialist](cs-demand-gen-specialist.md) — uses this agent's content as demand-gen fuel (gated assets, nurture content)
- [cs-webinar-marketer](cs-webinar-marketer.md) — webinar funnels that consume produced content
## References
- **Skill documentation:** [../../marketing-skill/skills/content-production/SKILL.md](https://github.com/alirezarezvani/claude-skills/tree/main/marketing-skill/skills/content-production/SKILL.md)
- **Planning sibling:** [../../marketing-skill/skills/content-strategy/SKILL.md](https://github.com/alirezarezvani/claude-skills/tree/main/marketing-skill/skills/content-strategy/SKILL.md)
- **Marketing domain guide:** [../../marketing-skill/CLAUDE.md](https://github.com/alirezarezvani/claude-skills/tree/main/marketing-skill/CLAUDE.md)
- **Agent development guide:** [../CLAUDE.md](https://github.com/alirezarezvani/claude-skills/tree/main/agents/CLAUDE.md)
---
**Last Updated:** June 11, 2026
**Status:** Production Ready
**Version:** 2.0
Reference in a new issue View git blame Copy permalink