---

name: shipany-page-builder description: Create new dynamic pages from a short spec (keywords, route/path, reference content).

ShipAny Page Builder (Dynamic Pages)

This skill creates new pages using ShipAny’s dynamic page builder approach: a page is rendered from a JSON file (per-locale), and activated by registering that JSON path in localeMessagesPaths.

This skill is intentionally much simpler than shipany-quick-start: it only creates new dynamic pages.

v1 edit scope (hard limit)

For v1, you may only:

• Add new multi-language dynamic page JSON files:
  • src/config/locale/messages/en/pages/** (new page JSON files only)
  • src/config/locale/messages/zh/pages/** (new page JSON files only)
• Update src/config/locale/index.ts:
  • Append the new 'pages/<slug>' entry to localeMessagesPaths (do not duplicate)

Hard rules:

• Do not modify any existing page JSON files (only create new ones).
• Do not touch routing code, layouts, components, or theme blocks.
• Do not add or edit any images under public/. Use placeholder images in JSON only.

Inputs (normalize first)

Normalize the user request into:

• route: string (e.g. /features/ai-image-generator)
• slug: string (derived from route, e.g. features/ai-image-generator)
• keywords: string[] (3–10)
• referenceCopy: optional raw text snippets, bullets, competitor copy, or notes
• sectionsWanted: optional list of section keys (default: ["hero","introduce","benefits","features","faq","cta"])

See references/00-guide.md.

Execution order

1. Normalize input + decide route/slug: references/00-guide.md
2. Generate locale files (based on configured localeNames) and register 'pages/<slug>':
   • Use scripts/create_dynamic_page.py
3. Quick validation checklist: references/01-checklist.md
4. Validate build (required):
   • Build: pnpm build

Bundled script (recommended)

Use the bundled script to create files + register the message path:

• scripts/create_dynamic_page.py

It is intentionally conservative:

• Creates missing folders
• Refuses to overwrite unless --force
• Adds TODO: markers for missing translations/content