Site starter

Skill ImYourBoyRoy/Portable_Web_toolkit/skills/site-starter

Portable Astro + Cloudflare toolkit with versioned skills for Codex, Cursor, Claude, and Antigravity; readiness, deployment, discovery, and starter CLIs.

Install

npx -y skills add ImYourBoyRoy/Portable_Web_toolkit --skill site-starter

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

1 stars1 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

Bootstraps a brand-new Astro + Cloudflare client site from Portable_Web_toolkit site-starter templates. Use when creating a new client project folder, copying package.json/wrangler.toml, linking Web_Toolkit, or choosing Workers vs Pages deploy target.

SKILL.md

3.4 KB, as published. Nobody here has run it

Site Starter

Creates a new client site outside the toolkit repo. Never use Portable_Web_toolkit root as the website.

Preflight

Resolve applicable instructions for the parent workspace and intended client repository. Select an exact target path, inspect it, and preserve unrelated work. Refuse a non-empty target unless the user separately approves every collision and its recovery plan.

Use the repository's current Node version on Windows, macOS, or Linux. Prefer portable Node commands; adapt only path and shell quoting to the active host.

Workers vs Pages

	Workers	Pages
Use when	SSR, API, KV/cron, `output: 'server'`	Static site, `output: 'static'`
Package	`site-starter/workers.package.json` → `package.json`	`site-starter/pages.package.json` → `package.json`
Wrangler	`workers.wrangler.toml` → `wrangler.toml`	`pages.wrangler.toml` → `wrangler.toml`
Astro config	`astro.config.workers.example.mjs` → `astro.config.mjs`	`astro.config.pages.example.mjs` → `astro.config.mjs`
Profile	`"deployTarget": "workers"`	`"deployTarget": "pages"`
Discovery doctor	`./dist/client`	`./dist`

Portable scaffold transaction

Resolve the toolkit root, exact empty site target, deploy target, and source template files.
Produce a file plan for package.json, wrangler.toml, astro.config.mjs, .env.example, and src/styles/.
Stage those files outside the target and verify their source names and expected destination paths.
Create the target only after the plan is accepted, then move the staged scaffold into the empty target. Use the agent's ordinary filesystem tools or native host commands; do not present Bash syntax as cross-platform.
Link Web_Toolkit with:

node "<toolkit-root>/scripts/link-web-toolkit.mjs" --toolkit-path "<toolkit-root>/Web_Toolkit" --project-root "<site-root>"

Copy and customize discovery templates according to Web_Toolkit/templates/discovery/README.md.
Obtain separate authorization before dependency installation or project-init apply-safe.
Create the site profile, run read-only readiness, and review its report.

npm scripts → Web_Toolkit

Starter package.json calls toolkit CLIs directly (./Web_Toolkit/...). No local scripts/ copy for headers, cache, wrangler check, or readiness.

Discovery layer

Copy from Web_Toolkit/templates/discovery/ per README: robots, sitemap, llms, humans, security.txt, content/search APIs, Schema.astro, middleware. Customize site-config.ts — no client-specific data in toolkit source.

After scaffold

BRAND_GUIDE.md + *.site-profile.json
.env from .env.example (never commit)
npm run build → npm run discovery:doctor
site-readiness → portable-web-toolkit for deploy

Rules

Secrets in client .env only
Link Web_Toolkit at project root before running npm scripts
Structural tokens.css only — visual identity comes from each client's Brand Guide
Never overwrite an existing project from a starter template