i18n Content Audit - SEO & GEO Content Optimization

🚨 BLOCKING REQUIREMENTS - Execute in Order

Two modes available:

• Report-Only (default): Audit and report, no file modifications
• Report + Fix (--fix): Audit, report, and automatically apply optimizations

You MUST complete each checkpoint before proceeding. Do NOT skip any step.

🔹 REPORT-ONLY MODE (Default)

✅ CHECKPOINT 1: Load Validated Keywords & Analyze Content

BLOCKING REQUIREMENT: You MUST read the keyword data file BEFORE analyzing content.

Read: .claude/skills/i18n-seo-localizer/data/keywords-{locale}.json
# OR: .codex/skills/i18n-seo-localizer/data/keywords-{locale}.json

Then read target content:

Read: src/config/locale/messages/{locale}/{page-path}.json

Confirm completion by stating: "✅ CHECKPOINT 1 COMPLETE: Loaded keywords and content for {locale}/{page}, extracted {N} current keywords"

Complete workflow: See references/phase-1-analyze.md - MUST read and execute ALL steps.

✅ CHECKPOINT 2: Evaluate Quality Across All Dimensions

BLOCKING REQUIREMENT: Evaluate ALL quality dimensions, do NOT skip any.

Evaluate in order:

1. Title & Description - Length, keyword placement, readability
2. E-E-A-T Score - Target ≥ 18/27
3. GEO Score - Target ≥ 30/40
4. Keyword Density - Within language-specific healthy range
5. Word Count - Meets minimum for target language
6. Seven Sweeps - Clarity, flow, engagement
7. Content Exclusions - No forbidden elements

Confirm completion by stating: "✅ CHECKPOINT 2 COMPLETE: Evaluated all dimensions, overall grade: {A/B/C/D/F}"

Complete workflow: See references/phase-2-evaluate.md - MUST read and execute ALL steps.

Scoring methodology: See references/scoring-guide.md

✅ CHECKPOINT 3: Generate Comprehensive Report

BLOCKING REQUIREMENT: Report MUST include all required sections.

Required report sections:

1. Executive Summary (Overall Grade)
2. Keyword Analysis (current vs validated)
3. Title & Description Audit
4. E-E-A-T Assessment (with score)
5. GEO Assessment (with score)
6. Seven Sweeps Results
7. Content Exclusion Check
8. Action Items (priority order)
9. Recommended Rewrites
10. Next Steps

Confirm completion by stating: "✅ CHECKPOINT 3 COMPLETE: Generated comprehensive report with {N} recommendations"

Report template: See references/phase-3-report.md - MUST follow template structure.

✅ CHECKPOINT 4: Provide Optimization Recommendations

BLOCKING REQUIREMENT: Recommendations MUST be specific and actionable.

Deliverables:

• Optimized title and description (exact text)
• Section-by-section improvements (specific changes)
• Implementation priority (high/medium/low)
• Expected impact estimation (traffic, ranking)

Confirm completion by stating: "✅ CHECKPOINT 4 COMPLETE: Provided {N} actionable recommendations"

Complete workflow: See references/phase-4-recommend.md - MUST read and execute ALL steps.

🔸 REPORT + FIX MODE (--fix flag)

Execute Checkpoints 1-4 first, then proceed to Checkpoint 5.

✅ CHECKPOINT 5: Apply Optimizations (Only with --fix)

BLOCKING REQUIREMENT: MUST apply ALL recommended fixes, not selective.

Fix steps (in order):

1. Keyword rewriting (using validated data)
2. Title & Description optimization
3. Content optimization (E-E-A-T, GEO)
4. Copy quality refinement (Seven Sweeps)
5. Content exclusion cleanup
6. Apply changes to JSON file
7. Update sitemap-config.ts
8. Verify build passes
9. Generate fix summary

Confirm completion by stating: "✅ CHECKPOINT 5 COMPLETE: Applied all fixes, build passes, {N} improvements made"

Complete workflow: See references/phase-5-fix.md - MUST read and execute ALL steps.

📋 Quick Reference

SEO Standards: See ../_shared/references/seo-standards.md

Quality Targets:

• Word count: EN 800+, ZH 500+, JA/KO 600+, European 800+
• Keyword density: ZH 2.0-3.0%, EN/European 1.8-2.5%, JA/KO 2.0-2.8%
• E-E-A-T: ≥ 18/27
• GEO: ≥ 30/40

Content Exclusions:

• ❌ Do NOT include: metadata.keywords, footer.friendLinks, backlinks

Complete checklist: See references/audit-checklist.md

🔄 Complete Workflow Documentation

Phase 1 (Analyze): references/phase-1-analyze.md Phase 2 (Evaluate): references/phase-2-evaluate.md Phase 3 (Report): references/phase-3-report.md Phase 4 (Recommend): references/phase-4-recommend.md Phase 5 (Fix): references/phase-5-fix.md - Only with --fix flag

Examples: references/examples.md Troubleshooting: references/troubleshooting.md

🆚 Skill Comparison

Last Updated: 2026-02-03