content-production_skill

Overview

This skill executes a full content production pipeline that turns a topic from a blank page into a publish-ready article, guide, or blog post. It focuses on writing, researching, drafting, and optimizing content for SEO, readability, and conversion. Use it when you need an end-to-end execution engine rather than strategy or repurposing.

How this skill works

Choose one of three modes: Research & Brief (competitive analysis and a detailed brief), Draft (build the outline and write the full piece), or Optimize & Polish (SEO, readability, and publish checklist). The skill gathers context, enforces citation and quality gates, and outputs deliverables such as content briefs, full drafts, or annotated optimized drafts. It proactively flags risks like thin content, intent mismatch, or missing sources.

When to use it

• You need a complete article or long-form post written from scratch
• You have a topic and want a research-backed brief before drafting
• You already have a draft and need SEO and readability optimization
• You want a publish-ready piece with meta tags, OG copy, and internal links
• You must ensure every factual claim has a source before publishing

Best practices

• Provide marketing-context.md or supply title, target keyword, audience, goal, length, and existing links in one shot
• Start with the appropriate mode: brief first if research is needed, draft if brief exists, optimize if draft exists
• Build an outline before writing; keep 4–7 H2s and a hooky H1
• Cite 3–5 credible sources for data and avoid vague claims like 'studies show' without a link
• Run the SEO and readability passes and pass the publish gates (readability ≥70, sources, images, internal links)

Example use cases

• Write a 1,500-word guide on onboarding developer tools targeting a specific keyword
• Produce a content brief and outline for a product comparison article to outrank competitors
• Draft a blog post from an approved brief and include internal links and CTA
• Optimize an existing draft: title tag, meta description, image alt text, and readability fixes
• Run the pre-publish checklist and return a publish-ready HTML or markdown file