content-production
by alirezarezvanicontent-production is a Content Marketing skill that turns a topic, keyword, and audience brief into a publish-ready article, blog post, guide, tutorial, or comparison. It supports brief creation, template selection, drafting, SEO optimization, AI-citation readiness, brand voice checks, and pre-publish quality gates.
This skill scores 84/100, which makes it a solid listing candidate for directory users who want an agent to produce SEO-oriented blog posts, articles, or guides with less guesswork than a generic writing prompt. The repository evidence shows clear triggers, real workflow substance, supporting checklists/templates, and runnable quality scripts, though adoption would be easier with explicit installation guidance and a short README.
- Strong triggerability: the frontmatter names concrete prompts such as “write a post about,” “draft an article,” and “I need a blog post,” plus clear exclusions for adjacent skills.
- Operationally useful end-to-end workflow: SKILL.md asks for required context up front, checks for `.claude/product-marketing-context.md`, and frames the skill as a production pipeline rather than a strategy tool.
- Good execution leverage beyond prompting: supporting references cover briefs, templates, AI citation readiness, and optimization, while scripts provide scoring, SEO optimization, brand voice analysis, and quality gates.
- No install command or README is present in the skill path, so users must infer installation from the broader repository or directory tooling.
- The workflow appears optimized for blog/article/guide production; it explicitly excludes strategy, repurposing, and social-caption-only use cases.
Overview of content-production skill
What content-production does
content-production is a marketing execution skill for turning a topic, keyword, and audience brief into a publish-ready article, blog post, guide, tutorial, comparison, or similar long-form asset. It is built for the “write the piece” stage: research framing, brief creation, drafting, SEO optimization, readability checks, AI-citation readiness, and pre-publish review.
Best fit for Content Marketing teams
The content-production skill is strongest for Content Marketing teams that already know what they want to publish but need a reliable production workflow. It fits B2B SaaS, developer tools, technical marketing, and authority-building content where structure, search intent, brand voice, and conversion goals matter. It is less useful if you only need a quick caption, a campaign calendar, or strategy discovery.
What makes it different from a generic prompt
A generic “write a blog post” prompt often jumps straight to drafting. This skill encourages the agent to collect missing context first, select an appropriate content template, create a brief, produce the draft, then run optimization gates. The included references cover content briefs, template selection, SEO checks, and AI answer-engine citation formatting, which makes the workflow more operational than a one-off prompt.
Important boundaries before install
Use content-production when you are producing new content from a blank page. Do not use it as the main tool for content strategy, editorial calendars, or repurposing an existing asset into social posts, newsletters, or clips. It can support SEO-focused production, but it does not replace keyword research tools, subject-matter expert interviews, fact checking, or your CMS publishing process.
How to Use content-production skill
content-production install context
Install the skill from the repository path:
npx skills add alirezarezvani/claude-skills --skill content-production
After installing, inspect marketing-skill/skills/content-production/SKILL.md first. Then read templates/content-brief-template.md, references/content-brief-guide.md, references/content-templates.md, references/optimization-checklist.md, and references/ai-citation-readiness.md. If you plan to use the helper scripts, review scripts/content_scorer.py, scripts/content_quality_gates.py, scripts/seo_optimizer.py, and scripts/brand_voice_analyzer.py.
Inputs the skill needs
For strong content-production usage, give the agent a compact but complete brief: topic, primary keyword, audience, search intent, goal, product or brand context, desired length, format, examples to match or avoid, internal links, must-include points, and evidence sources. If your project has .claude/product-marketing-context.md, the skill is designed to read it before asking unnecessary questions.
Weak input: “Write a post about onboarding.”
Stronger input: “Use content-production to draft a 1,800-word B2B SaaS guide targeting customer onboarding software. Audience: heads of CS at Series B SaaS companies. Goal: drive demo requests without sounding salesy. Angle: onboarding software fails when it automates tasks but not accountability. Include sections on handoffs, activation metrics, playbooks, and renewal impact. Use a confident, practical tone.”
Suggested workflow for a publish-ready article
Start by asking the agent to create or confirm the brief before drafting. Then have it choose the content template: how-to guide, comparison, pillar page, tutorial, FAQ, case study, listicle, or thought leadership. After the outline is approved, generate the draft section by section rather than all at once for high-stakes content.
A practical content-production guide workflow is:
- Confirm context and missing inputs.
- Define angle, reader problem, keyword, and conversion goal.
- Select the best template from
references/content-templates.md. - Build an outline with H1/H2/H3 structure.
- Draft with answer-first section openings.
- Add examples, evidence, and internal links.
- Run optimization and quality checks.
- Revise for brand voice and publish readiness.
Practical tips that improve output quality
Give the skill a differentiated angle, not just a topic. “Email marketing best practices” produces generic content; “why open-rate benchmarks mislead B2B SaaS teams after Apple Mail Privacy Protection” gives the model a position to defend. Provide audience maturity too: a beginner guide and an expert comparison need different explanations, assumptions, and examples.
For SEO work, specify the primary keyword once, then give related terms only if they matter. For AI-citation readiness, ask for self-contained 120–180 word passages, clear entity names, and direct answers after H2s. For brand consistency, provide two or three approved writing samples or run scripts/brand_voice_analyzer.py against existing content before revision.
content-production skill FAQ
Is content-production only for SEO content?
No. The skill supports SEO-oriented production, but it can also draft thought leadership, tutorials, case studies, comparison articles, and knowledge-base style content. SEO is most useful when you provide a target keyword and intent. If the piece is purely narrative or campaign-led, focus the prompt on audience, angle, proof, and desired reader action.
When should I not use this skill?
Do not use it when the main problem is deciding what to publish next. That belongs to content strategy. Do not use it when you are adapting an existing webinar, article, or report into other formats; that is repurposing. Also avoid it for short-form-only work such as social captions unless the captions are part of a larger article workflow.
Can beginners use the content-production skill?
Yes, but beginners should rely on the brief and template references instead of asking for a full draft immediately. The skill works best when the user can answer basic questions about audience, goal, and topic. If those are unclear, ask the agent to interview you once, produce a brief, and flag assumptions before writing.
How does it fit into an existing marketing stack?
The skill sits between planning and publishing. Use your SEO tool for SERP research, your product marketing docs for positioning, your analytics for audience insight, and your CMS for final publishing. content-production helps convert those inputs into a structured, optimized draft and a pre-publish checklist.
How to Improve content-production skill
Improve content-production results with better briefs
The fastest way to improve content-production output is to make the brief more specific. Include the reader’s situation, the pain they are trying to solve, what they already believe, what they should believe after reading, and what action they should take next. Add constraints such as “avoid beginner definitions,” “include implementation steps,” or “compare against manual workflows.”
Common failure modes to watch for
Watch for generic openings, unsupported statistics, overlong paragraphs, weak differentiation, and sections that repeat the same point under different headings. The included content_quality_gates.py script is useful because it treats some issues as blockers, not preferences: broken heading hierarchy, missing sources for statistics, title length problems, and absent alt text should be fixed before publication.
Use scripts and references as revision tools
Run scripts/content_scorer.py to get a 0–100 view of readability, SEO, structure, and engagement. Use scripts/seo_optimizer.py for search-focused adjustments, and scripts/brand_voice_analyzer.py when tone consistency matters. Then compare the draft against references/optimization-checklist.md and references/ai-citation-readiness.md before final editing.
Iterate after the first draft
Do not treat the first draft as final. Ask for one revision pass per objective: one for accuracy and evidence, one for structure and search intent, one for brand voice, and one for conversion. A strong revision prompt is: “Review this draft as a skeptical buyer. Mark sections that feel generic, unsupported, or too promotional. Then rewrite only the weak sections while preserving the approved outline.”