菜单
Scaffold a complete, self-contained Next.js 15 website with Tailwind CSS, TypeScript, and Vercel deployment. Creates production-ready project structure with design system, components, pages, SEO, and content management — ready to deploy in minutes.
默认使用会先检查来源的 Prompt；你也可以切换为直接命令，或下载本地副本。
决定是否安装前，请先阅读 SKILL.md，以及 SkillsMP 当前展示的配套文件。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
直接命令不会经过审查 Prompt；运行前请先检查来源。
npx skills add https://github.com/Abilityai/abilities --skill create-website命令会保持在同一行。复制前请横向滚动并检查完整内容。
想先保存到本地？可下载 SkillsMP 当前能够提供的文件。
基于 SOC 职业分类
正在显示 SKILL.md
| name | create-website |
| description | Scaffold a complete, self-contained Next.js 15 website with Tailwind CSS, TypeScript, and Vercel deployment. Creates production-ready project structure with design system, components, pages, SEO, and content management — ready to deploy in minutes. |
| disable-model-invocation | false |
| user-invocable | true |
| argument-hint | [project-name or description] |
| allowed-tools | Read, Write, Edit, Bash, Bash(gh *), Bash(vercel *), Glob, Grep, AskUserQuestion, mcp__vercel__deploy_to_vercel, mcp__vercel__list_teams, mcp__vercel__list_projects, mcp__vercel__get_project, mcp__vercel__list_deployments, mcp__vercel__get_deployment, mcp__vercel__get_deployment_build_logs |
| metadata | {"version":"1.3","created":"2026-03-25T00:00:00.000Z","updated":"2026-07-29T00:00:00.000Z","author":"Ability.ai","changelog":["1.3: Field-tested Studio upgrades — repeating item groups + toggles, verbatim-section guard (banner, flagged commits, optional webhook), per-section live links, and a multilingual variant (per-language content with per-key fallback, [lang] editors)","1.2: JSON-backed content layer + optional zero-dependency Studio CMS (/studio) for self-service editing","1.1: Prefer Vercel CLI for deployment; fall back to Vercel MCP, then to manual"]} |
ℹ️ First, set expectations: before anything else, print one short line with this skill's version and its most recent change — the top entry of
metadata.changelogabove — e.g.create-website vX.Y — recent: <summary>. Then proceed.
Scaffold a complete, production-ready Next.js 15 website deployable to Vercel.
For tech stack details and component patterns, see reference.md.
If $ARGUMENTS contains a project name or description, use it as context. Otherwise, ask:
Use AskUserQuestion:
./$PROJECT_NAME)If the description mentions more than one language, also ask which languages and which is canonical — a multilingual site switches the content layer and Studio to the multilingual variant (reference.md → Multilingual sites).
Use AskUserQuestion:
Map the choice to CSS variable values in Step 4.
cd $DESTINATION
npx create-next-app@latest $PROJECT_NAME \
--typescript \
--tailwind \
--eslint \
--app \
--src-dir=false \
--import-alias="@/*" \
--use-npm \
--yes
Wait for completion, then:
cd $DESTINATION/$PROJECT_NAME
npm install motion lucide-react clsx tailwind-merge
Create app/globals.css with semantic CSS variables based on the chosen design direction.
Follow the pattern from reference.md — Design System Variables. Key variables to define:
--bg-page, --bg-card, --bg-button-primary, --bg-button-secondary--text-primary, --text-muted, --text-inverse--border-subtle, --border-light--accent-primary, --accent-secondary--radius-sm, --radius-md, --radius-lg, --radius-fullAlso update tailwind.config.ts to reference these CSS variables and add common animations (fade-up, fade-in, blur-fade). See reference.md — Tailwind Config.
Create lib/utils.ts:
import { clsx, type ClassValue } from "clsx";
import { twMerge } from "tailwind-merge";
export function cn(...inputs: ClassValue[]) {
return twMerge(clsx(inputs));
}
Create these files following patterns in reference.md — Components:
components/layout/header.tsx — Sticky header with logo, navigation links, CTA button. Mobile hamburger menu.components/layout/footer.tsx — Footer with columns: company info, navigation, legal links, copyright.components/layout/mobile-menu.tsx — Slide-out mobile navigation.components/ui/button.tsx — Primary and secondary button variants using design system variables.components/ui/container.tsx — Max-width centered container with responsive padding.components/ui/section.tsx — Section wrapper with consistent vertical padding.Create app/layout.tsx:
<html>, <body> with font variables and design system classesmetadata export with:
%s | Brand NameCreate app/page.tsx with sections based on the website type:
For a company/agency site:
For a SaaS landing page:
For a portfolio:
Create each section as a separate component in components/home/.
For each page the user requested, create:
app/[page]/page.tsx — Page component with metadata exportcomponents/[page]/ if neededCommon pages and their patterns:
[slug] dynamic route with TypeScript dataEditable copy lives as JSON under content/, with thin typed wrappers in
lib/ that import it. This keeps content separate from code — so it can be
edited (by a person via the optional Studio CMS in Step 10b, or by an agent)
without touching components or redeploying by hand.
Create content/site.json (global, language-neutral facts):
{
"name": "$BRAND_NAME",
"tagline": "$TAGLINE",
"description": "$DESCRIPTION",
"url": "https://$DOMAIN",
"nav": [
{ "label": "About", "href": "/about" },
{ "label": "Contact", "href": "/contact" }
],
"footer": {
"legal": [
{ "label": "Privacy", "href": "/privacy" },
{ "label": "Terms", "href": "/terms" }
]
}
}
Create content/home.json for the homepage copy (hero, feature bullets, etc.),
and one content/[page].json per content-heavy page.
Then create lib/site-data.ts as a thin typed wrapper that imports the
JSON and re-exports it (components import from here, never from raw JSON):
import siteJson from "@/content/site.json";
import homeJson from "@/content/home.json";
export const siteConfig = siteJson;
export const home = homeJson;
export type SiteConfig = typeof siteJson;
export type Home = typeof homeJson;
Pretty-print the JSON with 2-space indent + a trailing newline (keeps diffs clean and matches what Studio writes back). Every section/component renders from these wrappers — no hardcoded copy in components, which is what makes the content editable in Step 10b.
Multilingual sites: split content per language (content/en/…,
content/bo/…) with identical keys, keep the canonical language complete, and
merge in the lib/ wrapper with the per-key fallback helper — blank translation
fields fall back to the canonical language by design; never machine-fill
them. See reference.md → Multilingual sites.
Offer a self-service, in-site content editor at /studio so a non-technical
owner can edit the site's copy themselves — passphrase login, schema-driven
forms (text, textareas, toggles, lists, and repeating item groups for news
posts / announcements / page sections), and each Publish commits the
relevant content/*.json to GitHub (which the host auto-redeploys). It adds
zero npm dependencies (Node crypto + fetch against the GitHub Contents
API) and builds directly on the JSON content layer from Step 10.
Use AskUserQuestion:
/studio editor; owner edits copy and publishes from the browser. Needs a GitHub repo + a fine-grained PAT.content/*.json (by a developer or an agent), no in-site editor.If the user chooses "No", skip to Step 11.
If "Yes", scaffold the Studio stack from reference.md — Studio CMS. Create exactly these files (templates are in reference.md):
lib/studio/auth.ts — passphrase + HMAC-signed cookielib/studio/github.ts — Contents API read/write (+ STUDIO_LOCAL_WRITE dev mode)lib/studio/schema.ts — declarative section schemas (edit to match the site's content/*.json)components/studio/fields.tsx — schema-driven form controlsapp/studio/layout.tsx, app/studio/login/page.tsx, app/studio/page.tsxapp/studio/[section]/page.tsx, app/studio/[section]/editor.tsxapp/studio/api/{login,logout,save}/route.tsMark any word-for-word content (a founder's letter, a historical account, legal
text) with verbatim: true in its schema — the editor shows an "edit with
care" banner, the dashboard badges the section, commits are flagged ⚠️, and the
optional STUDIO_NOTIFY_WEBHOOK pings the maintainer on every such edit.
For a multilingual site, the editor routes become
app/studio/[lang]/[section]/…, the schema gains a lang axis, and translation
editors show canonical values as placeholders — apply the deltas in
reference.md → Multilingual sites.
Then:
usePathname so they return null on /studio, and add disallow: "/studio"
to app/robots.ts (see reference.md → Hiding Studio)..env.example (see reference.md → Environment
variables): STUDIO_PASSWORD, STUDIO_SESSION_SECRET, GITHUB_TOKEN,
GITHUB_REPO, GITHUB_BRANCH, optional STUDIO_COMMIT_NAME/_EMAIL,
STUDIO_LOCAL_WRITE, STUDIO_NOTIFY_WEBHOOK.echo "STUDIO_SESSION_SECRET=$(openssl rand -base64 32)"
.env.local (gitignored) with the passphrase + secret and
STUDIO_LOCAL_WRITE=1, so /studio works in dev before any PAT exists.STUDIO_COMMIT_EMAIL must map to a GitHub account the host (Vercel) is
allowed to deploy from, or the host blocks the deploy and edits silently
never go live. Use the repo owner's GitHub noreply email.Note for the summary (Step 20): Studio's production env vars
(STUDIO_PASSWORD, STUDIO_SESSION_SECRET, GITHUB_TOKEN, GITHUB_REPO) must
be set in the host's project settings (e.g. Vercel → Settings → Environment
Variables), not just .env.local.
Create these files:
app/sitemap.ts — Dynamic sitemap generation from routesapp/robots.ts — Robots.txt configurationapp/not-found.tsx — Custom 404 pageCreate vercel.json (minimal — Next.js handles most config):
{
"framework": "nextjs"
}
Update next.config.ts:
Create a CLAUDE.md in the project root with:
# CLAUDE.md
## Quick Start
**Stack:** Next.js 15 (App Router), TypeScript, Tailwind CSS
**Commands:**
- `npm run dev` — Start dev server at localhost:3000
- `npm run build` — Production build
- `npm run lint` — Run ESLint
## Project Structure
[List the created directories and their purposes]
## Design System
[Reference the CSS variables in globals.css]
## Content Management
Editable copy lives as JSON under `content/` (e.g. `content/site.json`,
`content/home.json`); `lib/site-data.ts` imports it and re-exports typed values
that components render from. Edit the JSON to change the site — no component
changes needed.
[If Studio was added in Step 10b, also document: owner self-service editing at
`/studio` (passphrase login → publish → host redeploys), the `lib/studio/`
modules, how to add a new editable section (content JSON + `lib/` wrapper +
`SectionSchema` entry), and the required env vars.]
npm run build
If the build fails, read the error output, fix the issue, and rebuild. Do not proceed until the build passes.
Initialize git and create a GitHub repository using the GitHub CLI:
git init
git add -A
git commit -m "Initial scaffold: Next.js 15 + Tailwind + TypeScript website"
Check if gh is available:
gh --version
If gh is NOT installed: tell the user:
GitHub CLI (`gh`) is not installed. Install it:
brew install gh
Then authenticate:
gh auth login
Skip to Step 20 (Summary) with manual instructions.
If gh is available, check auth status:
gh auth status
If not authenticated, tell the user to run gh auth login and skip to Step 20.
If authenticated, use AskUserQuestion:
If user chooses "Skip", skip to Step 20.
Otherwise, create the repo and push:
gh repo create $PROJECT_NAME --[public|private] --source=. --push
This creates the repo, sets the remote, and pushes in one command.
Prefer the Vercel CLI — it deploys directly from the local project without needing the GitHub→Vercel webhook to fire, gives immediate URLs, and works without any MCP setup. Fall back to the Vercel MCP only if the CLI is unavailable and the user doesn't want to install it.
Probe both options in parallel:
vercel --version 2>/dev/null
Also attempt one Vercel MCP call (e.g., mcp__vercel__list_teams) to see if the MCP server is connected.
Decision tree:
CLI available → use CLI path (Step 17a). Skip MCP entirely.
CLI not installed, MCP connected → use MCP path (Step 17b).
Neither available → offer to install the CLI:
## Vercel CLI not installed
The fastest way to deploy is the Vercel CLI:
npm i -g vercel
Then run `vercel login` once. After that, re-run this wizard or deploy manually with `vercel --prod` from the project directory.
Alternative: connect the Vercel MCP server:
claude mcp add --transport http vercel https://mcp.vercel.com
(then restart Claude Code and run `/mcp` to authenticate)
Or deploy via the dashboard:
1. Go to vercel.com/new
2. Import the GitHub repo: $GITHUB_REPO_URL
3. Click Deploy
Skip to Step 20 (Summary).
Use AskUserQuestion:
vercel CLI to deploy from this directoryIf user chooses "Not yet", skip to Step 20.
Check auth status first:
vercel whoami 2>&1
If not logged in, the user must run vercel login themselves (it's interactive — open browser flow). Tell them:
You're not logged into Vercel. Run this in your terminal:
vercel login
Then re-run the wizard, or deploy yourself with:
cd $PROJECT_NAME && vercel --prod
Skip to Step 20.
If authenticated, deploy. From the project directory:
# First-time link + production deploy in one shot.
# --yes accepts defaults (project name = directory name, scope = personal),
# --prod targets production.
vercel --prod --yes
Capture the deployment URL from stdout (last line is typically the production URL).
If the user wants to link to a specific scope/team or override the project name, use vercel link --yes first with --scope <team> and --project <name>, then vercel --prod --yes.
Call mcp__vercel__deploy_to_vercel from the project directory. This connects the GitHub repository to Vercel; future pushes to main trigger automatic deployments.
CLI path: vercel --prod --yes blocks until the deployment finishes and prints the result. If it fails, the error is in the command output — read it, fix the issue, commit, and re-run vercel --prod --yes. To inspect a past deployment:
vercel ls # list recent deployments
vercel inspect <deployment-url> # detailed status
vercel logs <deployment-url> # build/runtime logs
MCP path: After deployment is initiated:
mcp__vercel__list_teams to get the team IDmcp__vercel__list_projects with the team ID to find the newly created projectmcp__vercel__list_deployments with the project ID and team ID to check deployment statusIf the deployment state is ERROR or FAILED:
mcp__vercel__get_deployment_build_logs with the deployment ID to get error detailsOnce deployment succeeds:
CLI path: the production URL was printed by vercel --prod --yes. To re-fetch:
vercel ls --prod | head -2
MCP path: Call mcp__vercel__get_project to get the production domain.
Display the live URL to the user.
Display:
## Website Created
**Project:** $PROJECT_NAME
**Location:** $DESTINATION/$PROJECT_NAME
**GitHub:** [repo URL if created, or "not created"]
**Pages:** [list of created pages]
**Design:** [chosen direction]
**Studio CMS:** [if added: "/studio (self-service editor)", else "not added"]
**Live URL:** [vercel URL if deployed, or "not yet deployed"]
### What's Next
1. **Start dev server:**
cd $PROJECT_NAME && npm run dev
2. **Edit content:**
- Content (copy): `content/*.json` (e.g. `content/site.json`, `content/home.json`)
- Design tokens: `app/globals.css`
- Add pages: `app/[page-name]/page.tsx`
[If Studio was added:]
- Self-service editor: visit `/studio` (passphrase: your `STUDIO_PASSWORD`).
In dev, `STUDIO_LOCAL_WRITE=1` edits files locally. For production, set
`STUDIO_PASSWORD`, `STUDIO_SESSION_SECRET`, `GITHUB_TOKEN`, `GITHUB_REPO`
in the host's project settings (Vercel → Settings → Environment Variables),
and make sure `STUDIO_COMMIT_EMAIL` maps to a GitHub account the host can
deploy from (else deploys are blocked).
3. **Redeploy:**
- Via CLI (instant, from local): `vercel --prod`
- Via GitHub (if connected): `git add -A && git commit -m "Update" && git push` — Vercel auto-deploys from `main`
[If Studio was added: the owner's Publish in /studio commits to `main` and triggers this same auto-deploy.]
--bg-page: 0 0% 100% (white)--bg-card: 0 0% 98% (off-white)--text-primary: 0 0% 9% (near-black)--text-muted: 0 0% 45% (gray)--border-subtle: 0 0% 90%--bg-page: 0 0% 5% (near-black)--bg-card: 0 0% 10% (dark gray)--text-primary: 0 0% 95% (near-white)--text-muted: 0 0% 65% (light gray)--border-subtle: 0 0% 20%backdrop-blur-xl bg-white/5--bg-page: 30 20% 97% (warm off-white)--bg-card: 0 0% 100% (white)--text-primary: 20 10% 15% (warm dark)--text-muted: 20 5% 45% (warm gray)--border-subtle: 30 10% 88%| Situation | Action |
|---|---|
npx create-next-app fails | Check Node.js version (needs 18.17+), suggest nvm use 18 |
npm install fails | Try clearing cache: npm cache clean --force, retry |
| Build fails | Read error output, fix the specific issue, rebuild |
| Directory already exists | Ask user: overwrite, pick different name, or use existing |
gh not installed | Tell user: brew install gh (macOS) or see https://cli.github.com |
gh not authenticated | Tell user to run gh auth login and follow prompts |
| GitHub repo name taken | Ask user for alternative name, retry with gh repo create <new-name> |
git push fails | Check remote is set correctly: git remote -v, re-add if needed |
| Vercel CLI not installed | Suggest npm i -g vercel, then vercel login. If user declines, fall back to MCP or manual dashboard import |
| Vercel CLI not logged in | Tell user to run vercel login themselves (interactive browser flow) and re-run, or finish manually with vercel --prod |
| Vercel CLI deploy fails | Read error from vercel --prod --yes output. Use vercel logs <url> for build logs. Fix, commit, re-run vercel --prod --yes |
| Vercel CLI project already exists | vercel link --yes links to the existing project before deploying |
| Vercel MCP not connected | Prefer the CLI path (npm i -g vercel). If the user wants MCP: claude mcp add --transport http vercel https://mcp.vercel.com, then restart and /mcp |
| Vercel MCP auth fails | Tell user to run /mcp in Claude Code to re-authenticate with Vercel |
| Vercel MCP deployment fails | Get build logs via mcp__vercel__get_deployment_build_logs, fix the issue, redeploy |
| Vercel project already exists (MCP) | Use existing project — the MCP will detect and link it |
Studio: /studio shows "Publishing isn't configured" | GITHUB_TOKEN not set. Add a fine-grained PAT (Contents: read/write on this repo), or set STUDIO_LOCAL_WRITE=1 for local-only editing |
| Studio: login always fails | STUDIO_PASSWORD unset/mismatched, or STUDIO_SESSION_SECRET shorter than 16 chars. Set both; regenerate the secret with openssl rand -base64 32 |
| Studio: "page changed since you opened it" (409) | Optimistic-concurrency guard — the file changed since load. Reload the editor and re-apply the edit |
| Studio: Publish succeeds but site never updates | Committer-email gotcha — STUDIO_COMMIT_EMAIL maps to an account the host won't deploy from, so the host blocked the deploy. Use the repo owner's GitHub noreply email |
Studio: public Header/Footer show on /studio | Add the usePathname guard (if (pathname?.startsWith("/studio")) return null;) to header.tsx/footer.tsx |
| Multilingual: translated page shows canonical-language text | By design — blank translation fields fall back per key. Fill the field in that language's Studio editor; never machine-fill it |
| Skill | Purpose |
|---|---|
| /agent-dev:create-playbook | Create operational skills for the website |