AgriciDaniel/claude-seo / skills/seo-content-brief
seo-content-brief
VerifiedGenerate competitive SEO content briefs with per-section word counts, competitor scoring, keyword placement guidance, and page-type templates. Supports both new page briefs and improve-existing-page briefs. Use when user says "content brief", "write a brief", "content outline", "blog brief", "service page brief", "brief for", "writing brief", "content plan", or "outline for".
| File | Kind | Size |
|---|---|---|
| LICENSE.txt | markdown | 147 B |
| SKILL.md | skill md | 10.9 KB |
| references/excluded-domains.md | markdown | 2.8 KB |
| references/keyword-density.md | markdown | 3.4 KB |
| references/page-type-templates.md | markdown | 7.0 KB |
references/keyword-density.md
View on GitHub<!-- Updated: 2026-04-17 -->
# Keyword Placement Rules
Internal readability and stuffing heuristic. Google publishes no target density; its spam policies treat repeating words "so often that it sounds unnatural" as keyword stuffing (developers.google.com/search/docs/essentials/spam-policies).
## Primary Keyword Use
**Use check:** Confirm the primary keyword appears naturally in important locations and does not read as forced repetition.
| Pattern | Assessment |
|---------|-----------|
| Missing from key locations | Review placement. The topic may be unclear. |
| Natural recurring use | Accept if it reads cleanly for users. |
| Noticeable repetition | Review required. May read unnaturally. |
| Forced repetition | Keyword stuffing risk. Rewrite for clarity and usefulness. |
**Practical example:** For a 1,000-word article, do not target a quota. Use the primary keyword where it helps users understand the page topic, including headings, body text, and image alt text when relevant.
**Diminishing returns:** Early mentions help establish topic context. After that, prioritise placement quality over quantity.
## Required Placement Locations
The primary keyword MUST appear in all of these:
1. **Title tag** (near the front, not buried at the end)
2. **H1 tag** (near the front)
3. **URL slug** (lowercase, hyphenated)
4. **Meta description** (naturally integrated)
5. **First paragraph / first 100 words** (establishes topic immediately)
Image alt text is not on this list. Write it to describe the image; the topic appears there only when the image actually shows it.
## Locations Where It Is NOT Required
- Every H2 or H3 (if the H1 covers the keyword, subheadings carry context naturally through semantic relationship)
- Every paragraph or section (clustering looks unnatural)
- Anchor text of every internal link (vary the anchor text)
## Secondary and Semantic Keywords
| Type | Count | Usage |
|------|-------|-------|
| Closely related terms | 5-8 | Distribute through body content and H2-H6 headings |
| Broader semantic terms | 10-15 | Cover related concepts and user intent variations |
| Synonyms | As natural | Improve readability and cover how people phrase the topic. |
## Distribution Rules
- **Spread evenly** throughout the content. Do not front-load all mentions into the introduction or cluster in one section.
- **Per-section guidance in briefs:** For each section in a content brief, specify:
- Which keyword (primary or secondary) should appear in the heading
- Whether the section body should include the primary keyword or a variation
- Format: "Use secondary keyword '[term]' in H2. Body: mention primary keyword once."
## Common Mistakes
1. **Exact-match obsession:** Using the exact phrase every time instead of natural variations. Google understands synonyms and related terms.
2. **Heading stuffing:** Putting the primary keyword in every H2 and H3. One H1 mention plus 1-2 H2 mentions is sufficient.
3. **Ignoring first 100 words:** The opening paragraph is the highest-value placement after the title and H1.
4. **Forgetting image alt text:** Every meaningful image needs descriptive alt text that names its subject. It helps accessibility and image search; it is not a keyword slot.
5. **Counting density at all:** "Web design", "website design", and "site design" all describe the same topic. Judge whether the page covers the topic clearly, not how often one exact string appears.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |