安装与交付包

选择安装方式

首页提供 Agent、MCP 和命令行三种入口：Agent 提供安装提示词，MCP 将工具连接到免费目录，命令行通过开源 skills CLI 安装已发布的 ZIP。选择 Codex、Claude Code 或 Cursor，获取对应说明。

选择一种方式，完成后再检查安装结果。下方以 Orbit Wallet 为例，自动使用当前网站地址与已发布版本；其他 Skill 和 Agent 可在首页选择。当前免费作品无需账号。

手动安装时，下载并检查 ZIP，将产品文件夹解压到工具支持的 Skills 目录。不要只复制 SKILL.md，参考资料与可运行源码也是交付包的一部分。

用 Agent 安装

1. 在编码 Agent 中打开目标项目，让它能读取项目并写入文件。
2. 在首页选择「Agent」、所用工具与 Skill，复制安装提示词。下方是 Codex 安装 Orbit Wallet 的示例。
3. 将提示词发送给该 Agent。它会读取 install.md、检查 ZIP，并将完整文件夹安装到项目的 Skills 目录。已有同名 Skill 时，先比较和备份，再决定是否替换。
4. 让它报告安装路径和版本，并确认已识别。发现列表未刷新时，在同一项目中开启新会话。

读取 https://skills.onebtcdesign.com/demos/orbit-wallet/install.md，将 orbit-wallet Skill 安装到当前 Codex 项目的 .agents/skills/ 目录。先检查安装包，保留已有安装，并确认 Agent 能发现这个 Skill。

本例完成后，.agents/skills/orbit-wallet/ 应包含 SKILL.md、references/ 和 project/，且 Codex 能读取已安装的 Skill。仅复制提示词不算安装完成。

连接 MCP

本站公开端点为 /api/mcp，使用标准 Streamable HTTP。在首页选择「MCP」与 Agent，即可复制包含当前网站地址的完整连接命令或配置。

只读工具 search_skills、get_skill、get_installation 提供免费 Skill 搜索、详情、安装地址与命令。连接本身不会写入你的电脑，也不会自动安装 Skill；选择后需另行让 Agent 执行安装。该 MCP 服务没有金融交易或账号权限。

1. 在首页选择「MCP」与所用工具，或复制下方对应配置。连接地址自动取自当前网站。
2. Codex 或 Claude Code 需先安装对应工具的 CLI，再在目标项目终端运行连接命令；Claude Code 默认使用项目本地作用域。Cursor 将 JSON 合并到 .cursor/mcp.json，保留已有服务。
3. 刷新 MCP 连接或开启新的 Agent 会话，确认 jesn-design-skills 中出现 search_skills、get_skill、get_installation。
4. 向 Agent 发送下方搜索示例，查看 Skill 详情与安装目标后，再决定安装。
5. 另行让本机 Agent 按返回的说明执行安装，先备份已有版本，再检查安装结果。

codex mcp add jesn-design-skills --url 'https://skills.onebtcdesign.com/api/mcp'

claude mcp add --transport http jesn-design-skills 'https://skills.onebtcdesign.com/api/mcp'

Cursor 示例是文件内容，不是终端命令。若 .cursor/mcp.json 已有 mcpServers，将 jesn-design-skills 条目加入该对象即可。

{
  "mcpServers": {
    "jesn-design-skills": {
      "url": "https://skills.onebtcdesign.com/api/mcp"
    }
  }
}

使用 jesn-design-skills MCP 服务。
先用 search_skills 搜索英文关键词 "wallet"，再用 get_skill 查看 orbit-wallet。
调用 get_installation，skillId 为 "orbit-wallet"，agent 为 "codex"。
先向我展示 Skill 详情和安装目标，暂不安装。

示例获取 Codex 的安装说明；其他工具将 agent 改为 "claude-code" 或 "cursor"。确认 Skill 和目标目录后，再单独发送安装请求：

按 MCP 返回的对应 Agent 安装说明，将 orbit-wallet 安装到当前项目。
先检查 ZIP。若目标目录已存在，先备份并询问是否替换。
完成后报告安装路径与版本，读取 SKILL.md 和参考资料，并确认 Agent 能识别该 Skill。

Agent 能调用工具并返回真实目录结果，才表示 MCP 已连通。Skill 安装需另外检查：执行安装请求后，确认本机文件和识别结果。

用命令行安装

1. 在终端运行 node --version，确认使用 Node.js 22.20 或更高版本；这是 skills@1.7.4 CLI 的要求。
2. 在要安装 Skill 的目标项目中打开终端，先备份已有安装。
3. 复制下方对应 Agent 的命令；其他作品可在首页选择「命令行」、Agent 和 Skill。运行一条命令即可；若询问安装范围，项目安装选择 Project。
4. 等待 CLI 显示安装成功，再在 Agent 中打开同一项目，按下方步骤确认安装后开始任务。

node --version

npx skills@1.7.4 add 'https://skills.onebtcdesign.com/downloads/orbit-wallet-0.1.0.zip' --agent codex

npx skills@1.7.4 add 'https://skills.onebtcdesign.com/downloads/orbit-wallet-0.1.0.zip' --agent claude-code

npx skills@1.7.4 add 'https://skills.onebtcdesign.com/downloads/orbit-wallet-0.1.0.zip' --agent cursor

这些命令安装本站对应版本的 ZIP，保留 project/、references/ 和本地资源。Codex 与 Cursor 使用项目内的 .agents/skills/orbit-wallet/，Claude Code 使用 .claude/skills/orbit-wallet/。CLI 可能链接到共享副本，因此 Agent 目录是链接也可正常使用。

确认安装并开始使用

1. 让 Agent 在当前项目中定位已安装的 Skill，报告路径和版本；版本可从包内 manifest.json 读取。
2. 确认 SKILL.md、references/ 和 project/ 位于同一 Skill 文件夹，且 project/vendor/ 存在。让 Agent 读取指令、设计规范与验收条件。
3. 确认 Agent 已识别 Skill。若未识别，先检查目录结构并在同一项目开启新会话，不要急于重复安装。
4. 提供品牌、目标页面和需求，先完成一个具体改动。检查结果与验证记录后，再扩大任务。

找到当前项目中已安装的 orbit-wallet Skill。
报告安装路径及 manifest.json 中的版本。
确认 references/、project/ 和 project/vendor/ 完整。
读取 SKILL.md、references/design.md 与 references/acceptance.md。
确认已识别，并在修改前概括设计约束。

使用已安装的 orbit-wallet Skill，为我的品牌调整钱包页面。
先读取设计规范与验收条件。
复用当前项目组件，保留精确的金额计算。
使用我提供的品牌资源和需求，完成后检查桌面与手机页面。

交付包结构

orbit-wallet/
  SKILL.md
  agents/openai.yaml
  references/
    design.md
    acceptance.md
  project/
    README.md
    package.json
    pnpm-lock.yaml
    vendor/
    …

每个 ZIP 只有一个根文件夹。根目录是可安装的 Skill，project/ 是独立应用。共享模块已放入 project/vendor/，应用不依赖本站仓库才能运行。

运行独立源码

独立源码要求 Node.js 22.12 或更高版本及 pnpm 10.30.3；skills CLI 另要求 Node.js 22.20 或更高版本。先进入已安装 Skill 内的 project/ 再执行以下命令，不要在 Skills 父目录运行。开发服务会输出本地地址，每款产品使用独立端口。

pnpm install --frozen-lockfile
pnpm dev

pnpm build
pnpm typecheck
pnpm test

更新已有安装

替换安装前核对版本。先保留或备份本地修改，再让 Agent 比较新版指令与源码。更新后重新运行验收检查。

遇到问题时

• 找不到 Skill：确认 SKILL.md 直接位于以 Skill 名称命名的文件夹内，没有因解压多套一层。检查当前项目和对应 Agent 的 Skills 目录，先开启新会话，再考虑重装。
• MCP 搜索无结果：当前搜索内容为英文，可用 wallet、vault、trading 等英文关键词，或先让 Agent 列出可用 Skills，再缩小范围。
• MCP 无法连接：检查复制的地址及客户端是否能访问。localhost 指向客户端所在电脑，云端 Agent 无法使用仅运行在你电脑上的本地服务。使用本地网站时，保持开发服务运行。
• 浏览器打开 /api/mcp 返回 405：该端点接收 MCP POST 请求，不提供普通网页。请在 MCP 客户端中检查连接，并尝试调用工具。
• 命令行安装前失败：检查 Node.js 22.20+、包注册表访问和 ZIP 地址。重试前先备份已有文件；添加 --yes 不能修复下载失败，还可能跳过替换确认。
• 源码无法运行：进入 Skill 内的 project/，保留 vendor/ 与锁文件，按 project/README.md 操作。端口被占用时，先复用或停止该项目已有服务，再启动新实例。