Content optimization
Skill bg-szy/TOP-SKILLS/skills/superskills/content-optimization
全球最大的 Claude Code 技能聚合库 · 收录 3900+ 来自 12+ 来源的技能，提供在线搜索与趋势分析看板 / The world's largest Claude Code skill aggregation hub — 3900+ skills from 12+ sources with online search and trend dashboard
npx -y skills add bg-szy/TOP-SKILLS --skill content-optimizationAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
2 things to look at
- no licenseNo license file was found in the repository. Code published without one is not open source by default, so using it at work is a question for whoever answers licensing questions where you are.
- 4 stars4 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
What its author says it does
Copied from the file, not written here
When the user wants to optimize content for SEO—word count, H2 keywords, keyword density, multimedia, tables, lists. Also use when the user mentions "content length," "word count," "keyword stuffing," "H2 keywords," "keyword density," "tables," "bullet points," or "content structure." For keywords, use keyword-research.
SKILL.md
8.1 KB, ~1.9k tokens by cl100k_base, as published. Nobody here has run it
SEO Content: Content Optimization
Guides on-page content optimization: word count, heading keywords, keyword density vs stuffing, multimedia, tables, and lists. Complements heading-structure (structure) and content-strategy (planning).
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.
Scope
- Word count: For articles, see article-content (word count by type). This skill covers generic content length strategy.
- H2 keywords: Placement, quantity, variation
- Keyword density vs stuffing: Natural use; avoid manipulation
- Multimedia: Images, tables, lists, video for structure and Featured Snippets. See featured-snippet for snippet-specific optimization; video-optimization for video SEO.
Initial Assessment
Check for project context first: If .claude/project-context.md or .cursor/project-context.md exists, read it for target keywords and content type.
Identify:
- Content type: Article, guide, listicle, pillar, news
- Target keyword: Primary and secondary
- Competitors: Top 10 average length and structure — see competitor-research
Word Count
Google does not rank by word count. Length should match search intent and topic depth. A 1,000-word post that satisfies intent can outrank a 3,000-word thin piece.
Reference Ranges by Content Type
For article word count by type (news, how-to, listicle, pillar, etc.), see article-content. Generic ranges:
| Content type | Word count | Notes |
|---|---|---|
| News / announcements | 300–600 | Time-sensitive; concise |
| Standard articles / how-tos | 1,000–1,500 | Single topic; actionable |
| Listicles / guides | 1,200–2,000 | "Top 10," "Best X" |
| Pillar / cornerstone | 2,000–3,500+ | Comprehensive; cluster hub |
Strategy
- Analyze top 10 for target keyword — average length and depth
- Match intent — informational often needs ~40% longer than transactional
- Value over padding — each section must add genuine value; avoid fluff
- Comprehensive coverage — answer the query and related questions
H2 Heading Keywords
Placement
- Primary keyword: Include naturally in at least one H2 when relevant
- Related keywords: Use LSI and long-tail in other H2s for topical coverage
- Avoid stuffing: Headings must stay clear and readable; organic placement only
Quantity
- No strict limit — one H2 per major section; structure follows content
- Typical article: 4–8 H2s; pillar: 8–15+ H2s
- Hierarchy: H1 → H2 (major sections) → H3 (subsections); don't skip levels
Best Practices
| Practice | Purpose |
|---|---|
| Descriptive H2s | Search engines understand context; users scan |
| Answer-first | Place direct answer in first 40–50 words after H2 for Featured Snippets; see featured-snippet |
| Keyword variation | Use related terms; avoid repeating exact phrase in every H2 |
| Logical flow | H2s outline the article; support topical authority |
Keyword Density vs Keyword Stuffing
Definitions
| Term | Meaning |
|---|---|
| Keyword density | (Keyword count / Total words) × 100; a metric, not a ranking factor |
| Keyword stuffing | Excessive, unnatural repetition to manipulate rankings; black-hat |
Current Guidance
- Keyword density is not a direct ranking factor — Google has stated since 2011 that repetition alone doesn't improve rankings
- Reference range: 0.5%–1.5% for most content; some sources cite up to 2.5%
- Use density mainly to avoid stuffing — if density exceeds ~2–3% and reads unnaturally, reduce
- Prioritize natural placement: title, H1, first 100 words, 1–2 H2s, body; avoid forced repetition
How to Avoid Stuffing
- Write for users first; keywords should fit naturally
- Use synonyms, related terms, and question phrasing
- If a sentence sounds awkward with the keyword, rewrite
- Monitor: if every paragraph repeats the exact phrase, simplify
Multimedia: Images, Tables, Lists
Images
| Practice | Purpose |
|---|---|
| Alt, file names, captions | See image-optimization for full image SEO (alt, format, responsive, lazy loading, image sitemap, LCP, captions for Featured Snippets) |
| Original over stock | Unique images signal E-E-A-T — see eeat-signals |
Content placement: Put images near relevant text; captions support snippet thumbnails. See image-optimization for captions; featured-snippet for snippet context.
Video
| Practice | Purpose |
|---|---|
| Embed + metadata | VideoObject schema, video sitemap, thumbnail; see video-optimization |
| YouTube | Google prioritizes YouTube in search; GEO citation; see youtube-seo, generative-engine-optimization |
| Featured Snippet (video) | Video schema; timestamps/chapters; see featured-snippet |
Tables
- Use for: Comparisons, stats, specs, "X vs Y"
- Semantic HTML:
<table>,<thead>,<tbody>, clear column headers - Featured Snippets: ~6% of snippets are tables; optimize headers with target keywords. See featured-snippet
- Mobile: Responsive; avoid horizontal scroll when possible
- Data quality: No empty cells; consistent units; accurate, current data
Lists: Ordered vs Unordered
| Type | Use case | SEO / Snippet |
|---|---|---|
Ordered (<ol>) | Steps, rankings, sequences, "Top 10" | List snippets (~19% of Featured Snippets); how-to; see featured-snippet |
Unordered (<ul>) | Non-sequential items, features, options | Bullet snippets; definitions, options |
Best practices:
- Use semantic
<ol>and<ul>; avoid divs styled as lists - Answer-first: For snippet targets, put the direct answer in the first 40–50 words after the heading
- Concise items: List items should be scannable; expand in body if needed
- Logical order: Ordered lists = sequence matters; unordered = no sequence
GEO / AI Citation
Answer-first (direct answer in first 40–60 words after H2) supports both Featured Snippets and GEO. For article-level GEO (TL;DR, Key Takeaways, QAE pattern), see article-content and generative-engine-optimization. For Featured Snippet formats and optimization, see featured-snippet.
Content Audit Checklist
For article content audit (hook, QAE, product connection, CTA, references, gaps), see article-content. This skill covers generic content optimization (H2 keywords, multimedia, keyword density).
Output Format
- Word count recommendation by content type
- H2 outline with keyword placement
- Keyword density check (avoid stuffing)
- Structure (tables, lists) for Featured Snippet opportunity; see featured-snippet
- Multimedia checklist (images per image-optimization; tables, lists)
Related Skills
- heading-structure: H1–H6 hierarchy; H2 keyword placement
- content-strategy: Topic clusters, pillar + cluster
- keyword-research: Target keywords inform placement
- featured-snippet: Snippet formats, structure; answer-first
- howto-section-generator: How-to step sections;
<ol>lists; HowTo vs FAQ - eeat-signals: E-E-A-T; original images, trust
- image-optimization: Alt, captions, format, LCP, responsive, image sitemap
- video-optimization: Video SEO; VideoObject; video sitemap
- competitor-research: Competitor length and structure as reference
- article-content: Article word count by type; Content Audit Checklist; article body creation
Gives 0 of the 12 instructions most performance cost skills give in ~1.9k tokens
Counted across 803 of the 1,058 authors here whose files we hold, read 2026-08-06
- keep skill files under 500 linesin 82 of 803, across 17 files
- use imperative form in instructionsin 81 of 803, across 10 files
- draft assertions while test runs are in progressin 75 of 803, across 9 files
- create two to three realistic test promptsin 74 of 803, across 8 files
- write skill descriptions to be pushyin 72 of 803, across 7 files
- save test cases to evals jsonin 72 of 803, across 6 files
- ask questions about edge cases and input formatsin 71 of 803, across 6 files
- save timing data immediately when runs completein 70 of 803, across 5 files
- include all trigger conditions in the skill descriptionin 69 of 803, across 3 files
- launch all test runs in a single turnin 69 of 803, across 3 files
- capture intent before writing a skillin 67 of 803, across 1 file
- import directly instead of barrel filesin 52 of 803, across 15 files
Grouped from the skills themselves: near-identical wordings counted once, and counted by distinct author, so one author publishing three of these counts once. Length counted with cl100k_base; the agent that loads this file may tokenize it differently.