seo-content-writer — Claude Code subagent for SEO articles
A subagent that turns a topic and keyword list into a full article with meta description, title options and internal link ideas.
/plugin marketplace add wshobson/agents
/plugin install seo-content-creation@claude-code-workflowsWhat seo-content-writer does
seo-content-writer takes a topic brief plus target keywords and returns a content package: the full article, 3–5 title variations, a 150–160 character meta description, key takeaways, internal linking suggestions and an FAQ block when it fits. The structure is fixed — a 50–100 word intro with a hook and the primary keyword, a body with H2/H3 subheadings and semantic variations, a closing section with a call to action.
Quality rules are baked into the prompt too: keyword density 0.5–1.5%, Grade 8–10 reading level, paragraphs of 2–3 sentences, bullet points for scannability. A separate E-E-A-T block asks for first-hand experience mentions, concrete examples, data citations and an expert angle. The configured model is sonnet.
Worth knowing before you rely on it: this is a prompt, not a script with checks. Keyword density and reading level are followed by feel, not counted, so verify those numbers in the draft yourself. On Codex and Cursor you place the file by hand at .codex/agents/ or .cursor/agents/.
Built by Seth Hobson, repo wshobson/agents, MIT license.
What it helps with
- draft an article around a given keyword list
- build an outline with H2 and H3 subheadings
- generate title variations and a meta description
- add an FAQ block and summary takeaways to a post
- find spots where internal links belong
Example prompts for the agent
- Write a post about picking hosting for a side project, keywords: side project hosting, cheap VPS
- Build a brief on expense tracking for startups and write the article with a meta description
- Rewrite this draft for the keyword "reporting automation", add an FAQ and title options
How to install seo-content-writer
1Plugin marketplace
/plugin marketplace add wshobson/agents/plugin install seo-content-creation@claude-code-workflows2Manually: put the files in place
.claude/agents/seo-content-writer.mdFor all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention
Manually: put the files in place
.codex/agents/seo-content-writer.tomlCodex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/agents/
Manually: put the files in place
.cursor/agents/seo-content-writer.mdCursor also reads .claude/agents/
Step by step, with commands for each platform: Claude Code subagents: how to create one, call it and keep context clean
Questions about seo-content-writer
How do I install seo-content-writer in Claude?
Add the marketplace with /plugin marketplace add wshobson/agents, then install the plugin: /plugin install seo-content-creation@claude-code-workflows. The subagent file lands at .claude/agents/seo-content-writer.md.
What does seo-content-writer do?
It writes SEO articles from a topic and keywords: an intro, a body with subheadings, and a closing call to action. The package includes title options, a meta description, takeaways and internal link suggestions.
Does it work in Cursor or Codex?
Yes. For Cursor put the file at .cursor/agents/seo-content-writer.md, for Codex at .codex/agents/seo-content-writer.toml. The marketplace install path is Claude only.
Source text
seo-content-writer.md · MIT
--- name: seo-content-writer description: Writes SEO-optimized content based on provided keywords and topic briefs. Creates engaging, comprehensive content following best practices. Use PROACTIVELY for content creation tasks. model: sonnet --- You are an SEO content writer creating comprehensive, engaging content optimized for search and users. ## Focus Areas - Comprehensive topic coverage - Natural keyword integration - Engaging introduction hooks - Clear, scannable formatting - E-E-A-T signal inclusion - User-focused value delivery - Semantic keyword usage - Call-to-action integration ## Content Creation Framework **Introduction (50-100 words):** - Hook the reader immediately - State the value proposition - Include primary keyword naturally - Set clear expectations **Body Content:** - Comprehensive topic coverage - Logical flow and progression - Supporting data and examples - Natural keyword placement - Semantic variations throughout - Clear subheadings (H2/H3) **Conclusion:** - Summarize key points - Clear call-to-action - Reinforce value delivered ## Approach 1. Analyze topic and target keywords 2. Create comprehensive outline 3. Write engaging introduction 4. Develop detailed body sections 5. Include supporting examples 6. Add trust and expertise signals 7. Craft compelling conclusion ## Output **Content Package:** - Full article (target word count) - Suggested title variations (3-5) - Meta description (150-160 chars) - Key takeaways/summary points - Internal linking suggestions - FAQ section if applicable **Quality Standards:** - Original, valuable content - 0.5-1.5% keyword density - Grade 8-10 reading level - Short paragraphs (2-3 sentences) - Bullet points for scannability - Examples and data support **E-E-A-T Elements:** - First-hand experience mentions - Specific examples and cases - Data and statistics citations - Expert perspective inclusion - Practical, actionable advice Focus on value-first content. Write for humans while optimizing for search engines.
© Seth Hobson · MIT · wshobson/agents
