Skill: SEO Audit for Concept Pages
Use this skill to perform a focused SEO audit on concept documentation pages for the 33 JavaScript Concepts project. The goal is to maximize search visibility for JavaScript developers.
When to Use
- •Before publishing a new concept page
- •When optimizing underperforming pages
- •Periodic content audits
- •After major content updates
- •When targeting new keywords
Goal
Each concept page should rank for searches like:
- •"what is [concept] in JavaScript"
- •"how does [concept] work in JavaScript"
- •"[concept] JavaScript explained"
- •"[concept] JavaScript tutorial"
- •"[concept] JavaScript example"
SEO Audit Methodology
Follow these five steps for a complete SEO audit.
Step 1: Identify Target Keywords
Before auditing, identify the keyword cluster for the concept.
Keyword Cluster Template
| Type | Pattern | Example (Closures) |
|---|---|---|
| Primary | [concept] JavaScript | closures JavaScript |
| What is | what is [concept] in JavaScript | what is a closure in JavaScript |
| How does | how does [concept] work | how do closures work |
| How to | how to use/create [concept] | how to use closures |
| Why | why use [concept] | why use closures JavaScript |
| Examples | [concept] examples | closure examples JavaScript |
| vs | [concept] vs [related] | closures vs scope |
| Interview | [concept] interview questions | closure interview questions |
Step 2: On-Page SEO Audit
Check all on-page SEO elements systematically.
Step 3: Featured Snippet Optimization
Verify content is structured to win featured snippets.
Step 4: Internal Linking Audit
Check the internal link structure.
Step 5: Generate Report
Document findings using the report template.
Keyword Clusters
Build a keyword cluster for the concept using this pattern:
- •Primary:
[concept] JavaScript - •What is:
what is [concept] in JavaScript - •How does:
how does [concept] work - •How to:
how to use [concept] - •Examples:
[concept] JavaScript example - •vs:
[concept] vs [related] - •Interview:
[concept] interview questions
Audit Checklist (Condensed)
Title & Meta
- •Title is 50-60 chars, keyword in first half, ends with "in JavaScript"
- •Meta description is 150-160 chars, starts with action verb, includes keyword
Keyword Placement
- •Keyword in title, description, first 100 words, and at least one H2
- •Avoid keyword stuffing; use variations naturally
Content Structure
- •Opening question hook + short answer
- •Code example within first 200 words
- •"What you'll learn" info box + clear H2 sections
- •Key takeaways and common mistakes sections
Featured Snippet Readiness
- •40-60 word "What is X" definition
- •At least one question-style H2
- •Tables or steps where relevant
Internal Linking
- •3-5 relevant internal links in body
- •Descriptive anchor text
- •Related Concepts section with 4 cards
Technical
- •No broken links
- •Images have alt text
- •Page renders correctly on mobile
Report Template (Short)
# SEO Audit: [Concept] ## Scores - Title: /4 - Meta: /4 - Keyword placement: /5 - Structure: /6 - Snippet: /4 - Internal linking: /4 - Technical: /4 ## Key Issues - [Issue 1] - [Issue 2] ## Priority Fixes 1. [Fix 1] 2. [Fix 2]
Summary
When auditing a concept page for SEO:
- •Identify target keywords using the keyword cluster for that concept
- •Check title tag — 50-60 chars, keyword first, hook, ends with "JavaScript"
- •Check meta description — 150-160 chars, action word, keyword, specific value
- •Verify keyword placement — Title, description, first 100 words, H2
- •Audit content structure — Question hook, early code, Info box, short paragraphs
- •Optimize for featured snippets — 40-60 word definitions, numbered steps, tables
- •Check internal linking — 3-5 links, good anchors, Related Concepts section
- •Generate report — Document score, issues, and prioritized fixes
Remember: SEO isn't about gaming search engines — it's about making content easy to find for developers who need it. Every optimization should also improve the reader experience.