@hanzlaa/rcode 4.3.2 → 4.4.0

package/rcode/skills/seo/on-page-seo-auditor/references/audit-templates.md

@@ -0,0 +1,427 @@
+# On-Page SEO Auditor — Output Templates
+
+Detailed output templates for on-page-seo-auditor steps 1-11. Referenced from [SKILL.md](https://github.com/aaron-he-zhu/seo-geo-claude-skills/blob/main/optimize/on-page-seo-auditor/SKILL.md).
+
+---
+
+## Step 1: Gather Page Information
+
+```markdown
+### Audit Setup
+
+**Page URL**: [URL]
+**Target Keyword**: [primary keyword]
+**Secondary Keywords**: [additional keywords]
+**Page Type**: [blog/product/landing/service]
+**Business Goal**: [traffic/conversions/authority]
+```
+
+---
+
+## Step 2: Audit Title Tag
+
+```markdown
+## Title Tag Analysis
+
+**Current Title**: [title]
+**Character Count**: [X] characters
+
+| Criterion | Status | Notes |
+|-----------|--------|-------|
+| Length (50-60 chars) | Pass/Warn/Fail | [notes] |
+| Keyword included | Pass/Warn/Fail | Position: [front/middle/end] |
+| Keyword at front | Pass/Warn/Fail | [notes] |
+| Unique across site | Pass/Warn/Fail | [notes] |
+| Compelling/clickable | Pass/Warn/Fail | [notes] |
+| Matches intent | Pass/Warn/Fail | [notes] |
+
+**Title Score**: [X]/10
+
+**Issues Found**:
+- [Issue 1]
+- [Issue 2]
+
+**Recommended Title**:
+"[Optimized title suggestion]"
+
+**Why**: [Explanation of improvements]
+```
+
+---
+
+## Step 3: Audit Meta Description
+
+```markdown
+## Meta Description Analysis
+
+**Current Description**: [description]
+**Character Count**: [X] characters
+
+| Criterion | Status | Notes |
+|-----------|--------|-------|
+| Length (150-160 chars) | Pass/Warn/Fail | [notes] |
+| Keyword included | Pass/Warn/Fail | [notes] |
+| Call-to-action present | Pass/Warn/Fail | [notes] |
+| Unique across site | Pass/Warn/Fail | [notes] |
+| Accurately describes page | Pass/Warn/Fail | [notes] |
+| Compelling copy | Pass/Warn/Fail | [notes] |
+
+**Description Score**: [X]/10
+
+**Issues Found**:
+- [Issue 1]
+
+**Recommended Description**:
+"[Optimized description suggestion]" ([X] chars)
+```
+
+---
+
+## Step 4: Audit Header Structure
+
+```markdown
+## Header Structure Analysis
+
+### Current Header Hierarchy
+
+```
+H1: [H1 text]
+  H2: [H2 text]
+    H3: [H3 text]
+    H3: [H3 text]
+  H2: [H2 text]
+    H3: [H3 text]
+  H2: [H2 text]
+```
+
+| Criterion | Status | Notes |
+|-----------|--------|-------|
+| Single H1 | Pass/Warn/Fail | Found: [X] H1s |
+| H1 includes keyword | Pass/Warn/Fail | [notes] |
+| Logical hierarchy | Pass/Warn/Fail | [notes] |
+| H2s include keywords | Pass/Warn/Fail | [X]/[Y] contain keywords |
+| No skipped levels | Pass/Warn/Fail | [notes] |
+| Descriptive headers | Pass/Warn/Fail | [notes] |
+
+**Header Score**: [X]/10
+
+**Issues Found**:
+- [Issue 1]
+- [Issue 2]
+
+**Recommended Changes**:
+- H1: [suggestion]
+- H2s: [suggestions]
+```
+
+---
+
+## Step 5: Audit Content Quality
+
+```markdown
+## Content Quality Analysis
+
+**Word Count**: [X] words
+**Reading Level**: [Grade level]
+**Estimated Read Time**: [X] minutes
+
+| Criterion | Status | Notes |
+|-----------|--------|-------|
+| Sufficient length | ✅/⚠️/❌ | [comparison to ranking content] |
+| Comprehensive coverage | ✅/⚠️/❌ | [notes] |
+| Unique value/insights | ✅/⚠️/❌ | [notes] |
+| Up-to-date information | ✅/⚠️/❌ | [notes] |
+| Proper formatting | ✅/⚠️/❌ | [notes] |
+| Readability | ✅/⚠️/❌ | [notes] |
+| E-E-A-T signals | ✅/⚠️/❌ | [notes] |
+
+**Content Elements Present**:
+- [ ] Introduction with keyword
+- [ ] Clear sections/structure
+- [ ] Bullet points/lists
+- [ ] Tables where appropriate
+- [ ] Images/visuals
+- [ ] Examples/case studies
+- [ ] Statistics with sources
+- [ ] Expert quotes
+- [ ] FAQ section
+- [ ] Conclusion with CTA
+
+**Content Score**: [X]/10
+
+**Gaps Identified**:
+- [Missing topic/section 1]
+- [Missing topic/section 2]
+
+**Recommendations**:
+1. [Specific improvement]
+2. [Specific improvement]
+```
+
+---
+
+## Step 6: Audit Keyword Usage
+
+```markdown
+## Keyword Optimization Analysis
+
+**Primary Keyword**: "[keyword]"
+**Keyword Density**: [X]%
+
+### Keyword Placement
+
+| Location | Present | Notes |
+|----------|---------|-------|
+| Title tag | ✅/❌ | Position: [X] |
+| Meta description | ✅/❌ | [notes] |
+| H1 | ✅/❌ | [notes] |
+| First 100 words | ✅/❌ | Word position: [X] |
+| H2 headings | ✅/❌ | In [X]/[Y] H2s |
+| Body content | ✅/❌ | [X] occurrences |
+| URL slug | ✅/❌ | [notes] |
+| Image alt text | ✅/❌ | In [X]/[Y] images |
+| Conclusion | ✅/❌ | [notes] |
+
+### Secondary Keywords
+
+| Keyword | Occurrences | Status |
+|---------|-------------|--------|
+| [keyword 1] | [X] | ✅/⚠️/❌ |
+| [keyword 2] | [X] | ✅/⚠️/❌ |
+
+### LSI/Related Terms
+
+**Present**: [list of related terms found]
+**Missing**: [important related terms not found]
+
+**Keyword Score**: [X]/10
+
+**Issues**:
+- [Issue 1]
+
+**Recommendations**:
+- [Suggestion 1]
+```
+
+---
+
+## Step 7: Audit Internal Links
+
+```markdown
+## Internal Linking Analysis
+
+**Total Internal Links**: [X]
+**Unique Internal Links**: [X]
+
+| Criterion | Status | Notes |
+|-----------|--------|-------|
+| Number of internal links | ✅/⚠️/❌ | [X] (recommend 3-5+) |
+| Relevant anchor text | ✅/⚠️/❌ | [notes] |
+| Links to related content | ✅/⚠️/❌ | [notes] |
+| Links to important pages | ✅/⚠️/❌ | [notes] |
+| No broken links | ✅/⚠️/❌ | [X] broken found |
+| Natural placement | ✅/⚠️/❌ | [notes] |
+
+**Current Internal Links**:
+1. "[Anchor text]" → [URL]
+2. "[Anchor text]" → [URL]
+3. "[Anchor text]" → [URL]
+
+**Internal Linking Score**: [X]/10
+
+**Recommended Additional Links**:
+1. Add link to "[Related page]" with anchor "[suggested anchor]"
+2. Add link to "[Related page]" with anchor "[suggested anchor]"
+
+**Anchor Text Improvements**:
+- Change "[current anchor]" to "[improved anchor]"
+```
+
+---
+
+## Step 8: Audit Images
+
+```markdown
+## Image Optimization Analysis
+
+**Total Images**: [X]
+
+### Image Audit Table
+
+| Image | Alt Text | File Name | Size | Status |
+|-------|----------|-----------|------|--------|
+| [img1] | [alt or "missing"] | [filename] | [KB] | ✅/⚠️/❌ |
+| [img2] | [alt or "missing"] | [filename] | [KB] | ✅/⚠️/❌ |
+
+| Criterion | Status | Notes |
+|-----------|--------|-------|
+| All images have alt text | ✅/⚠️/❌ | [X]/[Y] have alt |
+| Alt text includes keywords | ✅/⚠️/❌ | [notes] |
+| Descriptive file names | ✅/⚠️/❌ | [notes] |
+| Appropriate file sizes | ✅/⚠️/❌ | [notes] |
+| Modern formats (WebP) | ✅/⚠️/❌ | [notes] |
+| Lazy loading enabled | ✅/⚠️/❌ | [notes] |
+
+**Image Score**: [X]/10
+
+**Recommendations**:
+1. Add alt text to image [X]: "[suggested alt text]"
+2. Compress image [Y]: Currently [X]KB, should be under [Y]KB
+3. Rename [filename] to [better-filename]
+```
+
+---
+
+## Step 9: Audit Technical On-Page Elements
+
+```markdown
+## Technical On-Page Analysis
+
+| Element | Current Value | Status | Recommendation |
+|---------|---------------|--------|----------------|
+| URL | [URL] | ✅/⚠️/❌ | [notes] |
+| URL length | [X] chars | ✅/⚠️/❌ | [notes] |
+| URL keywords | [present/absent] | ✅/⚠️/❌ | [notes] |
+| Canonical tag | [URL or "missing"] | ✅/⚠️/❌ | [notes] |
+| Mobile-friendly | [yes/no] | ✅/⚠️/❌ | [notes] |
+| Page speed | [X]s | ✅/⚠️/❌ | [notes] |
+| HTTPS | [yes/no] | ✅/⚠️/❌ | [notes] |
+| Schema markup | [types or "none"] | ✅/⚠️/❌ | [notes] |
+
+**Technical Score**: [X]/10
+```
+
+---
+
+## Step 10: CORE-EEAT Content Quality Quick Scan
+
+Run a quick scan of on-page-relevant CORE-EEAT items. Reference: [CORE-EEAT Benchmark](https://github.com/aaron-he-zhu/seo-geo-claude-skills/blob/main/references/core-eeat-benchmark.md)
+
+```markdown
+## CORE-EEAT Quick Scan
+
+Content-relevant items from the 80-item benchmark:
+
+| ID | Check Item | Status | Notes |
+|----|-----------|--------|-------|
+| C01 | Intent Alignment | ✅/⚠️/❌ | Title promise = content delivery |
+| C02 | Direct Answer | ✅/⚠️/❌ | Core answer in first 150 words |
+| C09 | FAQ Coverage | ✅/⚠️/❌ | Structured FAQ present |
+| C10 | Semantic Closure | ✅/⚠️/❌ | Conclusion answers opening |
+| O01 | Heading Hierarchy | ✅/⚠️/❌ | H1→H2→H3, no skipping |
+| O02 | Summary Box | ✅/⚠️/❌ | TL;DR or Key Takeaways |
+| O03 | Data Tables | ✅/⚠️/❌ | Comparisons in tables |
+| O05 | Schema Markup | ✅/⚠️/❌ | Appropriate JSON-LD |
+| O06 | Section Chunking | ✅/⚠️/❌ | Single topic per section |
+| R01 | Data Precision | ✅/⚠️/❌ | ≥5 precise numbers |
+| R02 | Citation Density | ✅/⚠️/❌ | ≥1 per 500 words |
+| R06 | Timestamp | ✅/⚠️/❌ | Updated <1 year |
+| R08 | Internal Link Graph | ✅/⚠️/❌ | Descriptive anchors |
+| R10 | Content Consistency | ✅/⚠️/❌ | No contradictions |
+| Exp01 | First-Person Narrative | ✅/⚠️/❌ | "I tested" or "We found" |
+| Ept01 | Author Identity | ✅/⚠️/❌ | Byline + bio present |
+| T04 | Disclosure Statements | ✅/⚠️/❌ | Affiliate links disclosed |
+
+**CORE-EEAT Quick Score**: [X]/17 items passing
+
+> For a complete 80-item audit with weighted scoring, use `content-quality-auditor`.
+```
+
+---
+
+## Step 11: Generate Audit Summary
+
+```markdown
+# On-Page SEO Audit Report
+
+**Page**: [URL]
+**Target Keyword**: [keyword]
+**Audit Date**: [date]
+
+## Overall Score: [X]/100
+
+```
+Score Breakdown:
+████████░░ Title Tag: 8/10
+██████░░░░ Meta Description: 6/10
+█████████░ Headers: 9/10
+███████░░░ Content: 7/10
+██████░░░░ Keywords: 6/10
+█████░░░░░ Internal Links: 5/10
+████░░░░░░ Images: 4/10
+████████░░ Technical: 8/10
+```
+
+## Priority Issues
+
+### 🔴 Critical (Fix Immediately)
+1. [Critical issue 1]
+2. [Critical issue 2]
+
+### 🟡 Important (Fix Soon)
+1. [Important issue 1]
+2. [Important issue 2]
+
+### 🟢 Minor (Nice to Have)
+1. [Minor issue 1]
+2. [Minor issue 2]
+
+## Quick Wins
+
+These changes will have immediate impact:
+
+1. **[Change 1]**: [Why and how]
+2. **[Change 2]**: [Why and how]
+3. **[Change 3]**: [Why and how]
+
+## Detailed Recommendations
+
+### Title Tag
+- **Current**: [current title]
+- **Recommended**: [new title]
+- **Impact**: [expected improvement]
+
+### Meta Description
+- **Current**: [current description]
+- **Recommended**: [new description]
+- **Impact**: [expected improvement]
+
+### Content Improvements
+1. [Specific content change with location]
+2. [Specific content change with location]
+
+### Internal Linking
+1. Add link: "[anchor]" → [destination]
+2. Add link: "[anchor]" → [destination]
+
+### Image Optimization
+1. [Image 1]: [change needed]
+2. [Image 2]: [change needed]
+
+## Competitor Comparison
+
+| Element | Your Page | Top Competitor | Gap |
+|---------|-----------|----------------|-----|
+| Word count | [X] | [Y] | [+/-Z] |
+| Internal links | [X] | [Y] | [+/-Z] |
+| Images | [X] | [Y] | [+/-Z] |
+| H2 headings | [X] | [Y] | [+/-Z] |
+
+## Action Checklist
+
+- [ ] Update title tag
+- [ ] Rewrite meta description
+- [ ] Add keyword to H1
+- [ ] Add [X] more internal links
+- [ ] Add alt text to [X] images
+- [ ] Add [X] more content sections
+- [ ] Implement FAQ schema
+- [ ] [Additional action items]
+
+## Expected Results
+
+After implementing these changes:
+- Estimated ranking improvement: [X] positions
+- Estimated CTR improvement: [X]%
+- Estimated traffic increase: [X]%
+```

package/rcode/skills/seo/on-page-seo-auditor/references/bulk-audit-playbook.md

@@ -0,0 +1,116 @@
+# On-Page SEO — Site-Wide / Bulk Audit Playbook
+
+Referenced from [SKILL.md](https://github.com/aaron-he-zhu/seo-geo-claude-skills/blob/main/optimize/on-page-seo-auditor/SKILL.md). Use when the user wants on-page audits across >5 pages at once.
+
+---
+
+## When to use bulk mode
+
+- User wants to audit a content category (all blog posts, all product pages)
+- User is triaging a site-wide traffic drop across many URLs
+- Pre-publish audit for a content batch (5+ articles)
+- Competitive benchmarking across many URLs
+
+## Inputs accepted
+
+1. **URL list** — user pastes 5+ URLs
+2. **Sitemap URL** — scope to a section (e.g., `/sitemap-blog.xml`)
+3. **GSC export** — URLs ranked for target queries
+4. **Content type + sitemap** — "audit all 40 blog posts on example.com/blog/"
+
+## Workflow
+
+### Step 1 — Classify URLs into clusters
+
+Group URLs by content-type template (blog post / product / landing / guide / comparison / listicle). Surface the cluster distribution to the user before spending effort:
+
+```
+Your 40 URLs:
+- 24 blog posts (informational)
+- 10 guide pages (commercial)
+- 4 comparison pages (commercial)
+- 2 landing pages (transactional)
+```
+
+### Step 2 — Sample 2-3 URLs per cluster
+
+Run the standard on-page audit flow on the sampled URLs. Capture:
+- Title pattern (e.g., "all titles start with product name + `| Brand`")
+- H1 pattern consistency
+- Meta description quality distribution
+- CORE-EEAT dimension profile for the cluster
+
+### Step 3 — Extrapolate + confirm
+
+Produce cluster-level findings with scope:
+
+```
+### Cluster: Blog posts (24 URLs) — sample of 3
+
+**Common strengths**:
+- Title pattern is keyword-front-loaded + year qualifier (strong)
+- H1 matches title (strong)
+
+**Common weaknesses**:
+- Meta description length distribution: 8 short (<120 chars), 16 OK, 0 over — sampled 3: 2 short, 1 OK. **Estimate: 67% need rewrite.**
+- No H2 every 300 words — sampled 3: all violate. **Estimate: 24/24 affected.**
+- Thin intro (<60 words before first H2) — sampled 3: 2 affected. **Estimate: 16/24.**
+
+**CORE-EEAT profile (sampled)**:
+- Strong: C02, O01, O02
+- Weak: R01 (no citations), Exp02 (no first-person narrative), E01 (no original data)
+```
+
+### Step 4 — Portfolio priority
+
+```
+P0 (affects majority of cluster):
+- Rewrite meta descriptions across blog cluster (est. 16 URLs) — template improvement
+
+P1 (affects minority but high-impact):
+- Add author bio + credentials to all blog posts (est. 24 URLs) — CORE-EEAT Ept
+- Add 1 original stat per blog post (est. 20+ URLs) — CORE-EEAT R01
+
+P2 (single-page refinements):
+- Specific URLs flagged during deep sample: [list]
+```
+
+### Step 5 — Deliver bulk handoff
+
+- **Status**: DONE | DONE_WITH_CONCERNS
+- **Objective**: "Bulk on-page audit across <cluster_count> clusters (<total_urls> URLs)"
+- **Key Findings / Output**: per-cluster pattern findings + portfolio priority
+- **Evidence**: "Sampled N/M URLs; extrapolated to cluster level; confidence flagged per finding"
+- **Open Loops**: un-sampled clusters, URLs flagged for individual attention, data gaps (no keyword data, etc.)
+- **Recommended Next Skill**: `content-refresher` (for bulk content edits) OR `meta-tags-optimizer` (for title/description template work) OR `internal-linking-optimizer` (if linking pattern is the dominant issue)
+
+## Template suggestions (common bulk outputs)
+
+**Meta description template for a blog cluster**:
+
+```
+[Benefit in first 80 chars]. [Proof — number, source, or specific]. [CTA clause].
+— Target: 140-155 chars. Front-load the benefit.
+```
+
+**H1 template for product cluster**:
+
+```
+[Product name]: [differentiator] for [audience]
+— e.g., "Cloud Hosting: Managed Kubernetes for Small Teams"
+```
+
+**Alt-text template for images**:
+
+```
+[Descriptive noun phrase, 6-12 words, no "image of"]
+```
+
+## Minimum viable bulk input
+
+```
+1. URL list (or sitemap URL or content-type scope)
+2. Are these already ranking, or new/pre-publish?
+3. What's the business goal for this cluster?
+4. Any known template/CMS that affects all of them?
+```