创建**全新动态页面**或优化现有页面的 SEO(主要针对英文或初始页面)。输入:关键词、路由/路径、参考内容。使用场景:(1) 从简短规格创建全新页面(关键词、路由、参考内容),(2) 增强现有页面内容以改善 SEO(添加章节、改进文案、扩展 FAQ),(3) 用户说'创建页面'、'优化页面 SEO'、'添加章节',(4) 为新功能或产品创建落地页,(5) 创建英文源页面(后续可用 auto-i18n 国际化)。**不要用于:**(a) 国际化工作流(用 auto-i18n 创建或 i18n-content-audit 审计),(b) 审计现有i18n内容质量(用 i18n-content-audit),(c) 修复已有i18n页面的关键词问题(用 i18n-content-audit --fix),(d) 批量翻译页面(用 auto-i18n)。**核心功能:**创建新页面和内容优化,支持英文和非i18n场景,不处理国际化工作流。
Two modes available:
You MUST complete each checkpoint before proceeding. Do NOT skip any step.
BLOCKING REQUIREMENT: MUST normalize user request into structured input first.
Extract and confirm:
route: /features/ai-image-generatorslug: features/ai-image-generatorkeywords: ["AI image generator", "create AI art", ...]locale: en (or zh, ja, ko, etc.)mode: create-new OR optimize-existingConfirm by stating: "📝 INPUT NORMALIZED: route={route}, slug={slug}, {N} keywords, locale={locale}, mode={mode}"
Input guide: See references/00-guide.md
BLOCKING REQUIREMENT: For non-EN pages, MUST load validated keywords FIRST.
For EN pages: Skip to Checkpoint 2
For non-EN pages (zh, ja, ko, etc.):
Read: .claude/skills/i18n-seo-localizer/data/keywords-{locale}.json
# OR: .codex/skills/i18n-seo-localizer/data/keywords-{locale}.json
Extract validated keywords:
primary → Use in: Title, H1, Meta descriptionalternatives → Use in: H2s, body content, FAQsemanticVariants, relatedTerms, longTail → Use for diversityIf keyword NOT found in data file:
Confirm completion by stating: "✅ CHECKPOINT 1 COMPLETE: Loaded validated keywords for {locale}, primary='{keyword}', {N} alternatives"
BLOCKING REQUIREMENT: Content MUST follow unified SEO standards.
SEO Standards: See ../_shared/references/seo-standards.md for complete requirements.
Quick requirements:
Generation steps:
For new pages: Create multi-locale JSON files
For existing pages: Modify JSON to enhance content
Confirm completion by stating: "✅ CHECKPOINT 2 COMPLETE: Generated {word_count} words, density {X}%, H1 check: pass"
Complete SEO guidelines: See references/02-seo-best-practices.md
BLOCKING REQUIREMENT: MUST run anti-stuffing detection script.
python scripts/check_keyword_quality.py \
--file {generated_file} \
--keyword {primary_keyword} \
--locale {locale}
Checks performed:
If detection fails: Auto-rewrite (max 3 times). Do NOT bypass this check.
Confirm completion by stating: "✅ CHECKPOINT 3 COMPLETE: Quality check passed, exit code 0"
BLOCKING REQUIREMENT: For new pages, MUST register path and update configs.
For new pages:
Register message path:
python scripts/create_dynamic_page.py {slug} {locale}
OR manually update src/config/locale/index.ts
Update sitemap config:
Add entry to src/config/sitemap-config.ts
See references/05-sitemap-config.md
Configure internal linking (for L2+ pages):
Update internal-links.json for navigation
See references/07-internal-linking.md
For existing page optimization:
localeLastmod to todayConfirm completion by stating: "✅ CHECKPOINT 4 COMPLETE: Registered path, updated sitemap and internal links"
BLOCKING REQUIREMENT: Build MUST pass without errors.
pnpm build
Confirm completion by stating: "✅ CHECKPOINT 5 COMPLETE: Build passed successfully"
If build fails: Fix errors and rebuild. Do NOT mark complete until build passes.
Edit Scope:
public/Safety Constraints:
Content Exclusions:
i18n Development (CRITICAL): Always use explicit locale in getTranslations():
// CORRECT
const t = await getTranslations({ locale, namespace: 'pages.xxx' });
Input Guide: references/00-guide.md Validation Checklist: references/01-checklist.md SEO Best Practices: references/02-seo-best-practices.md i18n Development: references/04-i18n-best-practices.md Sitemap Config: references/05-sitemap-config.md SEO Quality Pipeline: references/06-seo-quality-pipeline.md Internal Linking: references/07-internal-linking.md
| Task | Use This Skill? | Alternative |
|---|---|---|
| Create new EN page | ✅ Yes | - |
| Create new non-EN page | ✅ Yes (if keyword validated) | auto-i18n (if translating from EN) |
| Optimize existing EN page | ✅ Yes | - |
| Translate EN → other language | ❌ No | auto-i18n |
| Audit existing i18n content | ❌ No | i18n-content-audit |
| Fix i18n quality issues | ❌ No | i18n-content-audit --fix |
Last Updated: 2026-02-03