agentleFS
Sign inStart free
choupiyangchoupiyang/ZAI_SKILLS/vercel-deploy/SKILL.md

vercel-deploy

Skill13 starsChanged 7 months agoMITView on GitHub

Deploy any web project (Next.js, React, HTML) to Vercel with one command. Use this skill whenever the user asks to deploy a website, publish a page, push to Vercel, go live, or get a permanent URL for their project. Also trigger when the user says things like '部署', '上线', '发布', '帮我弄个链接', 'deploy to vercel', or wants a shareable URL. IMPORTANT: Always use this skill for deployment — never skip it or deploy manually.

  • Deletes or force-pushes

We split this skill into the rules it gives an agent

10 rules. 0 are common, 5 are distinctive, and 5 are very specific to this project.

  • 0

    Common

    Most of the 26 edited versions we read keep these.

  • 5

    Distinctive

    This author's own choices. Worth a look.

  • 5

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Very specific:

    Read scripts/.token to check for a stored Vercel token.

    line 20
  2. Distinctive:

    If the token file does NOT exist or is empty:

    line 22
  3. Distinctive:

    Ask the user to provide their Vercel token

    line 23
  4. Distinctive:

    If the user specifies a name, use it (slugified: lowercase, hyphens, no special chars)

    line 30
  5. Distinctive:

    Keep it under 40 characters

    line 33
  6. Very specific:

    If output: "export" is not present, add it.

    line 44
  7. Very specific:

    Wait for build to complete.

    line 52
  8. Very specific:

    Remove output: "export" from next.config.ts so the dev server continues working normally.

    line 73
  9. Very specific:

    Always restore next.config.ts: after building. Forgetting this breaks the dev server.

    line 85
  10. Distinctive:

    If deployment fails, check the error message — common issues:

    line 87

“Common” is measured: kept by at least 6 in 10 of the 26 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Vercel Deploy Skill

This skill deploys the current Next.js project at /home/z/my-project/ to Vercel, producing a permanent, shareable URL. Each deployment gets its own Vercel project so multiple projects can coexist without overwriting each other.

Prerequisites

  • Vercel CLI is available via npx vercel
  • A valid Vercel token is stored in scripts/.token (first-time setup required)
  • The project at /home/z/my-project/ has valid Next.js source code

Deployment Workflow

Step 1: Ensure token exists

Read scripts/.token to check for a stored Vercel token.

If the token file does NOT exist or is empty:

  • Ask the user to provide their Vercel token
  • They can get one at https://vercel.com/account/tokens (Create Token → Full Account)
  • Once received, save it to scripts/.token (no newline at end)

Step 2: Determine project name

Generate a short, URL-safe project name based on context:

  • If the user specifies a name, use it (slugified: lowercase, hyphens, no special chars)
  • Otherwise, derive from the page title or content theme
  • Examples: ai-startup-article, chinese-font-catalog, portfolio-2026
  • Keep it under 40 characters

Step 3: Configure for static export

Temporarily modify /home/z/my-project/next.config.ts to add output: "export" if not already present. This is needed for static hosting on Vercel.

cd /home/z/my-project
# Check if output: "export" is already in next.config.ts

If output: "export" is not present, add it. Remember to remove it after building.

Step 4: Build static export

cd /home/z/my-project && npx next build

Wait for build to complete. Verify success by checking for out/index.html.

Step 5: Deploy to Vercel

cd /home/z/my-project/out
# Remove any previous .vercel config to avoid linking to wrong project
rm -rf .vercel
TOKEN=$(cat /home/z/my-project/skills/vercel-deploy/scripts/.token)
npx vercel deploy --yes --prod --token "$TOKEN" --name "$PROJECT_NAME"

The output will contain a line like:

Aliased: https://your-project.vercel.app

Extract and save this URL — it's the permanent link.

Step 6: Restore dev config

Remove output: "export" from next.config.ts so the dev server continues working normally.

Step 7: Report to user

Send the user a message with:

  • The permanent URL ( prominently displayed )
  • Confirmation that it's live and shareable
  • Note that this is an independent deployment and won't be affected by future projects

Important Notes

  • Each project gets its own Vercel project name, so deployments never overwrite each other.
  • Always restore next.config.ts after building. Forgetting this breaks the dev server.
  • The token is stored locally in scripts/.token and is never sent to the user or logged.
  • If deployment fails, check the error message — common issues:
    • Token expired → ask user for a new token
    • Project name conflict → add a suffix like -2
    • Build failure → check the build output for errors

Download now (ZIP)

  • Other versions29 projects use a version of this.

    Word for word · 0

    None found.

    Edited · 0

    None found.

    Wrote their own version · 29

    1. bytedance/deer-flow★ 84ksame name
    2. openai/skills★ 27ksame name
    3. stophobia/deerflow2.0-enhanced★ 821same name
    4. EvovexAI/EvoFlow★ 436same name
    5. JetBrains/skills★ 386same name
    6. Prompthon-IO/agent-systems-handbook★ 315same name
    7. baekenough/oh-my-customcode★ 42same name
    8. PracticalSwan/agent-skills★ 15same name
    9. Liuzln/openclaw-skills★ 6same name
    10. vercel-labs/vercel-deploy-codex-skill★ 5same name

    19 more not listed

    How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.

  • Used alongsideProjects with it also use chatgpt-apps, winui-app and 10 more.

    Other files people use alongside this one.

    Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
    • OpenAISkill

      chatgpt-apps

      Build, scaffold, refactor, and troubleshoot ChatGPT Apps SDK applications that combine an MCP server and widget UI. Use when Codex needs to design tools, register UI resources, wire the MCP Apps bridge or ChatGPT compatibility APIs, apply Apps SDK metadata or CSP or domain settings, or produce a docs-aligned project scaffold. Prefer a docs-first workflow by invoking the openai-docs skill or OpenAI developer docs MCP tools before generating code.

      Also in 4 projects that use this

    • OpenAISkill

      winui-app

      Bootstrap, develop, and design modern WinUI 3 desktop applications with C# and the Windows App SDK using official Microsoft guidance, WinUI Gallery patterns, Windows App SDK samples, and CommunityToolkit components. Use when creating a brand new app, preparing a machine for WinUI, reviewing, refactoring, planning, troubleshooting, environment-checking, or setting up WinUI 3 XAML, controls, navigation, windowing, theming, accessibility, responsiveness, performance, deployment, or related Windows app design and development work.

      Also in 3 projects that use this

    • stophobiaSkill

      surprise-me

      Create a delightful, unexpected "wow" experience for the user by dynamically discovering and creatively combining other enabled skills. Triggers when the user says "surprise me" or any request expressing a desire for an unexpected creative showcase. Also triggers when the user is bored, wants inspiration, or asks for "something interesting".

      Also in 3 projects that use this

    • HK-hubSkill

      ppt-generation

      Use this skill when the user requests to generate, create, or make presentations (PPT/PPTX). Creates visually rich slides by generating images for each slide and composing them into a PowerPoint file.

      Also in 3 projects that use this

    • stophobiaSkill

      github-deep-research

      Conduct multi-round deep research on any GitHub Repo. Use when users request comprehensive analysis, timeline reconstruction, competitive analysis, or in-depth investigation of GitHub. Produces structured markdown reports with executive summaries, chronological timelines, metrics analysis, and Mermaid diagrams. Triggers on Github repository URL or open source projects.

      Also in 3 projects that use this

    • HK-hubSkill

      consulting-analysis

      Use this skill when the user requests to generate, create, or write professional research reports including but not limited to market analysis, consumer insights, brand analysis, financial analysis, industry research, competitive intelligence, investment due diligence, or any consulting-grade analytical report. This skill operates in two phases — (1) generating a structured analysis framework with chapter skeleton, data query requirements, and analysis logic, and (2) after data collection by other skills, producing the final consulting-grade report with structured narratives, embedded charts, and strategic insights.

      Also in 3 projects that use this

    • +5 more from openai
  • In this repository46 other files it gives its agents.

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

Check your setup, free