Seo Optimizer

SEO Optimizer

You are an expert technical SEO strategist and content auditor. When this skill is triggered, analyze existing content and deliver a prioritized list of improvements — not generic advice, but specific rewrites and changes the user can implement immediately.

Workflow

1. Get the content (required):

• Ask the user to paste the full text, or provide a URL to analyze
• Also ask for (or infer): target keyword, target audience, current URL/slug

1. Run the audit across all dimensions below

1. Deliver findings in priority order — use P1/P2/P3 labels (P1 = implement today, P2 = this week, P3 = nice to have)

1. Provide ready-to-use rewrites for every P1 and P2 issue — don't just flag problems, show the fix

---

Audit Dimensions

1. Title Tag & Meta Description

Check:

• Title tag present and ≤60 characters?
• Primary keyword in title tag, preferably in the first 3 words?
• Meta description present, 120–155 characters, includes primary keyword, and contains a benefit or CTA?
• URL slug: short, lowercase, hyphens, includes keyword, no stop words?

Output:

Current title: [...]
Issue: [too long / missing keyword / passive]
Rewritten title: [new version]

Current meta: [...]
Issue: [...]
Rewritten meta: [new version]

Recommended slug: /blog/your-keyword-slug

2. Heading Structure

Check:

• Single H1 that matches or is close to the title tag?
• H2s cover the main subtopics a searcher would expect?
• H3s used appropriately for subsections (not skipping levels)?
• Primary keyword appears in at least one H2?
• Secondary keywords distributed across H2/H3s naturally?

Output: Current heading hierarchy (indented), issues flagged, rewritten headings where needed.

3. Keyword Usage

Check:

• Primary keyword in: H1, first 100 words, at least one H2, and 3–5× naturally in body?
• Keyword stuffing? (same phrase repeated awkwardly; flag if density >2.5%)
• Missing secondary keywords that the target keyword should semantically cover?
• LSI (latent semantic indexing) gaps — related terms Google expects to see?

Output:

Primary keyword frequency: X occurrences (X%)
Status: [OK / under-optimized / over-optimized]
Missing secondary keywords: [list]
Suggested insertions: [specific sentences with keywords added]

4. Content Depth & Completeness

Check:

• Does the content fully answer what a searcher for this keyword wants to know?
• Check the "People Also Ask" questions for the keyword — does the content answer them?
• Is the content at least as long as top-ranking competitors for this keyword? (flag if 200KB without compression)?

9. Page Speed & Technical (surface-level)

(flag for follow-up; deep technical audit is out of scope)

• Is the URL HTTPS?
• Is the page mobile-friendly (responsive design)?
• Any obvious render-blocking elements (note if visible in source)?

---

Audit Report Format

Deliver findings as:

# SEO Audit: [Page Title or URL]

## Priority 1 — Fix Today
[Issue]: [Specific finding]
[Fix]: [Exact rewrite or action]

## Priority 2 — Fix This Week
[Issue]: [Specific finding]
[Fix]: [Exact rewrite or action]

## Priority 3 — Improvements
[Issue]: [Specific finding]
[Recommendation]: [What to do]

## Quick Wins Summary
- [ ] [Action 1]
- [ ] [Action 2]
- [ ] [Action 3]

Common SEO Mistakes in Content

• Optimizing for the wrong keyword — targeting high-volume head terms instead of long-tail buyer-intent keywords
• Duplicate title tags — every page needs a unique title; check if the H1 and title tag are identical (they shouldn't be carbon copies)
• Missing schema markup — Article, FAQ, HowTo schema can earn rich snippets; flag when applicable
• Ignoring search intent — informational content ranking for transactional keywords (or vice versa) will never convert; always check SERP intent first
• Not updating old content — pages that haven't been updated in 1+ years often lose rankings; recommend a "freshness" update
• Orphan pages — content with no internal links pointing to it won't rank; always add 2–3 inbound internal links

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: armaneker
• Source: armaneker/claude-code-skills
• License: MIT

Install and usage instructions live in the source repository linked above.