Skip to content
Skills Library
DevOps & cloud · Automation

vercel-deploy

/vercel-deploy

TRIGGER WHEN: 用户要求"部署网页"、"发布到 Vercel"、"做个工具页面并上线"时。 处理 Web 项目的安全部署,支持非交互式 Token 验证及通用宿主项目管理。

Repository
ethan-agent ↗
Licence
MIT
Last repository change
25.10.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
1
Scripts
0
HTML comments
0
URLs in SKILL.md
1
Deprecation

No signals detected. Repository changed on 25.10.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What it does and when to use it

TRIGGER WHEN: 用户要求"部署网页"、"发布到 Vercel"、"做个工具页面并上线"时。 处理 Web 项目的安全部署,支持非交互式 Token 验证及通用宿主项目管理。

Triggers from the description

部署网页发布到 Vercel做个工具页面并上线
Original author description

TRIGGER WHEN: 用户要求"部署网页"、"发布到 Vercel"、"做个工具页面并上线"时。 处理 Web 项目的安全部署,支持非交互式 Token 验证及通用宿主项目管理。

How it works

  1. 🔑 密钥配置 (Secrets)
  2. 🛡️ 核心工作流 (Workflow)
  3. 避坑指南 (Gotchas)
Original SKILL.md headings · 67 lines, 203 words
SKILL.md preview
---
name: vercel-deploy
description: >
  TRIGGER WHEN: 用户要求"部署网页"、"发布到 Vercel"、"做个工具页面并上线"时。
  处理 Web 项目的安全部署,支持非交互式 Token 验证及通用宿主项目管理。
license: MIT
version: 1.0.0
source: internal (hermes agent)
---

# Vercel 极速部署 (Vercel Deploy)

本技能用于将静态页面或 Web 应用快速部署至 Vercel 环境。

## 🔑 密钥配置 (Secrets)

凭证文件优先级(按顺序查找,命中即停):

1. `~/.ethan/.secrets/vercel.env`(推荐,独立密钥文件)
2. `~/.ethan/.env`(统一 env 文件)

需要以下环境变量:

- `VERCEL_TOKEN` —— Vercel API 访问令牌(**必填**)
- `VERCEL_ORG_ID` —— 组织 ID(首次 `vercel link` 后由本地 `.vercel/` 写入,可选)
- `VERCEL_PROJECT_ID` —— 项目 ID(首次 `vercel link` 后由本地 `.vercel/` 写入,可选)

加载方式(执行部署前必须 source):

```bash
[ -f ~/.ethan/.secrets/vercel.env ] && source ~/.ethan/.secrets/vercel.env \
  || ([ -f ~/.ethan/.env ] && source ~/.ethan/.env)
```

**严禁在 SKILL.md 或终端输出中明文写入 Token 值。**

## 🛡️ 核心工作流 (Workflow)

### 1. 宿主模式 (Host Project)

默认将页面存入 `~/.ethan/web/tools/` 子目录,统一部署 `~/.ethan/web` 根项目以减少 Vercel 项目数。

### 2. 构建与部署 (Build & Deploy)

非交互式部署:

```bash
npx vercel --prod --yes --token "$VERCEL_TOKEN" --cwd "$HOME/.ethan/web"
```

部署完成后必须提取并返回 `https://...vercel.app` 链接。

### 3. pnpm 项目示例 (pnpm Workflow)

用户偏好 pnpm。对于 pnpm 项目:

```bash
# 1. 构建
pnpm install --frozen-lockfile && pnpm build

# 2. 部署构建产物(如 dist/ 或 build/)
npx vercel deploy --prod --yes --token "$VERCEL_TOKEN" --cwd ./dist

# 3. 若需显式传递组织/项目(覆盖 .vercel/ 本地配置)
VERCEL_ORG_ID="$VERCEL_ORG_ID" \
VERCEL_PROJECT_ID="$VERCEL_PROJECT_ID" \
npx vercel --prod --yes --token "$VERCEL_TOKEN"
```

## 避坑指南 (Gotchas)

- **本地路径**: 必须使用绝对路径传递给 `--cwd`(`~` 不会被 vercel CLI 展开,需用 `$HOME` 或实际路径)。
- **Link 错误**: 若项目未关联,加入 `--force` 参数或提示用户运行 `vercel link`。
- **环境污染**: 优先使用 `npx vercel` 而非全局安装的 `vercel`,避免版本污染。
- **pnpm 检测**: 通过 Vercel 自动构建时,确保 `package.json` 中 `packageManager` 字段为 `pnpm@<version>`,以触发 Vercel 的 pnpm 自动检测。

Versions

RepositoryScoreLicence
This page · llm011/ethan-agent100MIT
akillness/jeo-skills100MIT
seaworld008/commonly-used-high-value-skills100MIT
bytedance/deer-flow100MIT
lukedj78/dev-flow100MIT
PracticalSwan/agent-skills100MIT
S3YED/appie-kit100MIT
S3YED/appie-kit100MIT
JochenYang/Jochen-ai-rules100MIT

Database snapshot: 13.11.2026 · package version b8e67e4f4eb7 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 1 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 96vercel-deploy-ops
    Use when deploying or managing the user's Vercel.
  • 100vercel-cli-with-tokens
    Deploy and manage projects on Vercel using token-based authentication. Use when working with Vercel CLI using access tokens rather than interactive login — e.g. "deploy to vercel", "set up vercel", "a
  • 100vercel-cli-with-tokens
    Deploy and manage projects on Vercel using token-based authentication. Use when working with Vercel CLI using access tokens rather than interactive login — e.g. "deploy to vercel", "set up vercel", "add environment variables to vercel".
  • 100vercel-cli
    Deploy apps to Vercel. Use when asked to deploy, ship, or publish a web application, or manage Vercel projects, domains, and environment variables.
  • 100vercel-cli
    Deploy apps to Vercel. Use when asked to deploy, ship, or publish a web application, or manage Vercel projects, domains, and environment variables.
  • 95deploy-to-vercel
    Deploy applications and websites to Vercel. Use when the user requests deployment actions like "deploy my app", "deploy and give me the link", "push this live", or "create a preview deployment".

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.