content-strategy · kostja94 — Claude Code skill: content plan and topic clusters
Plans SEO content: a topic cluster map, pillar pages and an editorial calendar. Useful when you need a publishing plan, not one more article.
npx skills add kostja94/marketing-skills --skill content-strategy -a claude-codeWhat content-strategy does
The skill organizes content by topic instead of isolated keywords. A pillar page covers a broad term, 6–12 cluster articles cover subtopics, and internal links tie them together. That layout shows search engines and AI systems the site covers a subject end to end.
You get a cluster map, a calendar with topics, keywords and deadlines, an internal linking plan, and a plan for refreshing old pages. Before that, the skill looks at your keywords, existing content and team capacity. If a contextus.md file sits in the project root, it reads that and loads only the modules this task needs.
For editorial mix across blog, email, social and video, the description points to a separate content-marketing skill. This one handles the SEO side. One thing to watch: the skill advises refreshing clusters quarterly and evergreen pieces every 6–12 months, so a plan with no review date goes stale fast.
What it helps with
- build a topic cluster map for your site
- put together an editorial calendar with topics and deadlines
- split articles across queries and stop cannibalization
- plan internal links between pillar and cluster pages
- decide which old pages to refresh and when
Example prompts for the agent
- build a quarterly content plan: one pillar page and 8 cluster articles on our topic
- map topic clusters for the blog and show me the internal linking scheme
- make an editorial calendar from these keywords with publish dates
How to install content-strategy
1Skills CLI (Vercel)
npx skills add kostja94/marketing-skills --skill content-strategy -a claude-code2Manually: put the files in place
~/.claude/skills/content-strategy/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/content-strategy/
1Skills CLI (Vercel)
npx skills add kostja94/marketing-skills --skill content-strategy -a codex2Manually: put the files in place
.agents/skills/content-strategy/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add kostja94/marketing-skills --skill content-strategy -a cursor2Manually: put the files in place
.cursor/skills/content-strategy/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install kostja94/marketing-skills content-strategy2Manually: put the files in place
.github/skills/content-strategy/SKILL.md1Skills CLI (Vercel)
npx skills add kostja94/marketing-skills --skill content-strategy -a gemini-cli2Platform CLI
gemini skills install https://github.com/kostja94/marketing-skills --path skills/seo/content/content-strategyManually: put the files in place
.devin/skills/content-strategy/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add kostja94/marketing-skills --skill content-strategy -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about content-strategy
How do I install content-strategy in Claude?
Run npx skills add kostja94/marketing-skills --skill content-strategy -a claude-code. The skill file lands at ~/.claude/skills/content-strategy/SKILL.md.
What does content-strategy do?
It plans SEO content: builds a topic cluster map with a pillar page, prepares an editorial calendar and an internal linking plan, plus a refresh plan for existing pages.
How is content-strategy different from content-marketing?
content-strategy covers the SEO side: clusters, pillar pages, calendar. The skill description lists content-marketing for editorial mix across blog, email, social and video.
Source text
SKILL.md · MIT
---
name: content-strategy
description: When the user wants to plan content for SEO, create content calendar, or build topic clusters. Also use when the user mentions "content strategy," "content plan," "topic clusters," "pillar content," "pillar page," "cluster articles," "editorial calendar," "content hub," "content planning," "content clusters," "topic cluster strategy," "content strategy for SEO," or "content calendar." For editorial mix, use content-marketing.
metadata:
version: 1.1.1
---
# SEO Content: Content Strategy
Guides content strategy for SEO: topic clusters, pillar pages, cluster articles, and editorial planning. For content marketing across all channels (blog, email, social, video), see **content-marketing**. For translation workflow and multilingual content, see **translation**.
**When invoking**: On **first use**, if helpful, open with 1-2 sentences on what this skill covers and why it matters, then provide the main output. On **subsequent use** or when the user asks to skip, go directly to the main output.
## Initial Assessment
**Project context:** Read root `contextus.md` when present and load only the modules relevant to this task. Without Contextus, use available project material or user-provided facts and ask for missing information; do not create a parallel context system.
Identify:
1. **Keywords**: From keyword research — see **keyword-research** for discovery and clustering
2. **Existing content**: What already exists
3. **Resources**: Content capacity, tools
4. **Goals**: Traffic, conversions, authority
**Product-Led SEO**: Do SEO around product/users, not around industry/search engines. See **seo-strategy** for Product-Led SEO principle, products suited for SEO, and workflow order.
## Topic Clusters
Topic clusters organize content by **topic** rather than isolated keywords. A **pillar page** covers a broad core topic; **cluster articles** cover subtopics; all connect via internal links. This signals topical authority to search engines and AI systems.
### Structure
```
Pillar page (broad topic, 2,000-5,000+ words)
<-> internal links
Cluster 1 (subtopic, 800-2,500 words)
Cluster 2 (subtopic)
...
Cluster 6-12 (subtopics)
<-> cluster to cluster links
```
### Pillar Page
| Attribute | Guideline |
|-----------|-----------|
| **Length** | 2,000-5,000+ words; comprehensive guide |
| **Keyword** | Broad head term with search volume |
| **Role** | Hub; links to all cluster articles; targets primary topic |
| **Conversion** | Link to product/feature pages where relevant |
### Cluster Articles
| Attribute | Guideline |
|-----------|-----------|
| **Count** | 6-12 articles per pillar (minimum 6 for authority) |
| **Length** | 800-2,500 words each; focused on one subtopic |
| **Keyword** | Long-tail, specific intent per article |
| **Links** | Each cluster links to pillar; pillar links back; related clusters link to each other |
### Internal Linking Model
| Link type | Purpose |
|-----------|---------|
| **Pillar to Cluster** | Hub distributes authority; users discover subtopics |
| **Cluster to Pillar** | Signals relationship; passes equity to hub |
| **Cluster to Cluster** | Related subtopics; strengthens topical coverage |
### Structure and Content Equally Important
**Framework and body quality both matter**: TOC, chapter logic, and content depth are all essential for SEO and UX. Weak structure undermines strong writing; weak writing undermines strong structure. Plan both from the start.
### Why Topic Clusters Work
- **Topical authority**: Rank for multiple variations; comprehensive coverage signals expertise
- **Avoid cannibalization**: One page per topic/keyword; no competing pages
- **Better internal linking**: Clear logic; crawlers understand structure
- **AI citations**: Clustered content gets ~42% more AI citations than standalone
- **Traffic**: ~30% more organic traffic; rankings hold ~2.5x longer
### Implementation Steps
1. **Choose 3-7 core topics** -> business relevance, search demand, competitive opportunity
2. **Map subtopics** -> People Also Ask, competitor analysis, keyword tools
3. **Content audit** -> Identify existing pages that can become pillar or cluster; find gaps
4. **Build clusters first** (optional) -> Cluster pages often rank first; add pillar after
5. **Create pillar** -> Comprehensive guide; link to all clusters
6. **Establish links** -> Pillar <-> cluster; cluster <-> cluster
7. **Update quarterly** -> Maintain freshness and authority
### Example
- **Pillar**: "SEO Guide" (targets "SEO")
- **Clusters**: "Technical SEO," "On-Page SEO," "Link Building," "Content SEO," "Local SEO," "E-E-A-T"
## Content Types
| Type | Use | SEO Fit |
|------|-----|---------|
| **How-to guides** | Informational intent; high share potential | High -> matches search intent |
| **Comparisons** | Commercial intent; "X vs Y" | High |
| **List posts** | "Top 10," "Best X" | High |
| **Glossaries** | Definition queries; internal link hub | High |
| **Tools/calculators** | Linkable assets; engagement | High |
| **Case studies** | Proof; conversion support | Medium -> supports conversion |
| **Funding / PR** | Funding rounds, acquisitions | Low -> brand/PR, not search-driven |
| **Product updates** | Feature launches, release notes | Low -> internal audience |
| **News / Trending** | Industry news, hot topics | Medium -> quick spikes, short shelf life |
### Evergreen vs Timely Content Mix
- **Evergreen** (70-75%): Pillar guides, how-tos, comparisons, glossaries. Drives long-term traffic, backlinks, authority. Refresh every 6-12 months.
- **Timely** (25-30%): Seasonal, trending, news. Generates quick traffic, shows topical relevance. Link timely pieces into evergreen pillars.
- **Balance**: Too much evergreen = blog feels stale; too much timely = irregular traffic, constant content churn.
## Editorial Calendar
- Map keywords to content pieces
- Prioritize by opportunity (volume -> intent -> feasibility)
- Schedule by capacity
- Include update schedule for existing content
## Output Format
- **Topic cluster** map (pillar + 6-12 clusters)
- **Content calendar** (topics, keywords, deadlines)
- **Internal linking** plan
- **Update plan** for existing content
## Related Skills
- **content-marketing**: Content types, formats, channels, repurposing; SEO content is one channel
- **translation**: Multilingual content; translation workflow, glossary; avoid thin translations
- **seo-strategy**: SEO workflow order, Product-Led SEO, audit approach; use when planning SEO from scratch
- **website-structure**: Plan which pages to build; structure informs content clusters and pillar placement
- **keyword-research**: Keywords drive content plan
- **programmatic-seo**: Programmatic SEO for scaling pages with template + data; complements topic clusters
- **content-optimization**: Word count, H2 keywords, keyword density, multimedia, lists -> on-page content optimization
- **internal-links**: Clusters need internal linking
- **link-building**: Content strategy creates linkable assets
- **heading-structure**: Content structure uses headings
© kostja94 · MIT · kostja94/marketing-skills
Similar skills
Everything for SEO and GEO →content-strategy by other authors comes first.