shipany-quick-start
Automate first-pass customization of a new ShipAny (ShipAny Two) project from a short project brief (app name, domain/app URL, product description/features, reference links, and branding preferences). Use when the user says they are starting a new project.
When & Why to Use This Skill
The ShipAny Quick Start skill is a powerful automation tool designed to bootstrap and customize new web projects instantly. By analyzing a brief project description, it automatically configures essential components including SEO metadata, localized landing pages (EN/ZH), theme styles, and legal documentation. It streamlines the initial development phase by handling repetitive setup tasks and ensuring the project is build-ready following best practices.
Use Cases
- Rapidly bootstrapping a new SaaS or web application from a basic product brief to a functional, styled codebase.
- Automating the generation of multi-language landing pages and localized content structures for international markets.
- Ensuring consistent SEO optimization and legal compliance (Privacy Policy/Terms) for new domains right from the start.
- Quickly applying brand identity elements like logos, favicons, and color themes across a new project infrastructure.
| name | shipany-quick-start |
|---|---|
| description | Automate first-pass customization of a new ShipAny (ShipAny Two) project from a short project brief (app name, domain/app URL, product description/features, reference links, and branding preferences). Use when the user says they are starting a new project. |
ShipAny Quick Start (Project Bootstrap)
This skill is intentionally split into small reference modules. Load only the module(s) you need.
v1 edit scope (hard limit)
For the first pass, only modify the files listed in references/09-checklist.md.
- Do not change any other files (no routing, no components, no templates, no extra locale message files).
- Do not introduce login/auth/payment features unless explicitly requested.
Dev workflow (required)
- Before starting edits: run
pnpm install(once) to ensure dependencies are installed. - After finishing all edits: clear Next.js cache before validation, otherwise you may see stale assets (e.g. old
logo.png):- macOS/Linux:
rm -rf .next - Windows (PowerShell):
Remove-Item -Recurse -Force .next - Windows (cmd):
rmdir /s /q .next
- macOS/Linux:
- Then run
pnpm buildto validate the project (build + lint checks). If it fails, fix issues only within the v1 allowlist unless the user expands scope.
Project brief
Normalize the user’s request first:
references/00-project-brief.md
Execution order (ShipAny Two)
- App basics (env-driven):
references/01-env-app-info.md - SEO metadata:
references/02-seo-metadata.md - Landing page (EN/ZH):
references/03-landing-page.md- Page sections live in
src/config/locale/messages/{locale}/pages/index.json - Header/footer/nav live in
src/config/locale/messages/{locale}/landing.json
- Page sections live in
- Theme styles:
references/04-theme-styles.md - Logo + favicon:
references/05-logo-favicon.md - Sitemap:
references/06-sitemap.md - Legal pages:
references/07-legal-pages.md - Images (extract from links or use Picsum placeholders):
references/08-images.md - Minimal checklist:
references/09-checklist.md
Bundled script
scripts/fetch_og_image.py: Best-effort OG/Twitter preview image downloader for a reference link.