| name | i18n-content-audit |
| description | 审计和优化**已有国际化内容**的 SEO/GEO 合规性。两种模式：(1) 仅报告（默认，无 --fix 标志）：生成审计报告但不修改文件，适合想先审查建议的场景；(2) 报告 + 修复（--fix 标志）：生成报告并自动应用优化，适合自动修复质量问题的场景。输入：语言区域和页面路径。输出：包含关键词分析、质量评分和建议的综合报告。使用场景：(1) 审查现有国际化内容质量，(2) 用户说'audit/optimize/check SEO/review i18n quality'，(3) 验证内容是否符合质量标准，(4) 审计由 auto-i18n 创建的内容，(5) 修复关键词堆砌/密度问题。**不要用于：**(a) 创建新的国际化内容（用 auto-i18n），(b) 首次国际化英文页面（用 auto-i18n），(c) 审计英文源页面（用其他SEO审计技能），(d) 创建全新页面（用 shipany-page-builder）。**核心功能：**检查和优化已有i18n内容，不是创建新内容。 |
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
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:
- Title & Description - Length, keyword placement, readability
- E-E-A-T Score - Target ≥ 18/27
- GEO Score - Target ≥ 30/40
- Keyword Density - Within language-specific healthy range
- Word Count - Meets minimum for target language
- Seven Sweeps - Clarity, flow, engagement
- 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:
- Executive Summary (Overall Grade)
- Keyword Analysis (current vs validated)
- Title & Description Audit
- E-E-A-T Assessment (with score)
- GEO Assessment (with score)
- Seven Sweeps Results
- Content Exclusion Check
- Action Items (priority order)
- Recommended Rewrites
- 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):
- Keyword rewriting (using validated data)
- Title & Description optimization
- Content optimization (E-E-A-T, GEO)
- Copy quality refinement (Seven Sweeps)
- Content exclusion cleanup
- Apply changes to JSON file
- Update sitemap-config.ts
- Verify build passes
- 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
| Aspect | /auto-i18n | /i18n-content-audit | /i18n-content-audit --fix |
|---|
| Purpose | Create new content | Audit existing content | Audit + optimize content |
| Input | EN page + target locale | Existing locale page | Existing locale page |
| Output | New JSON file | Audit report only | Report + modified file |
| Modifies Files | Yes (creates new) | ❌ No | ✅ Yes (updates existing) |
| When to Use | New language support | Review before optimizing | Auto-fix quality issues |
Last Updated: 2026-02-03
