skill-add git:20260611.179bca1A

Immutable. This exact content is served forever at /api/v1/blob/f254abeadf34e0c4.

---
name: skill-add
description: 从 URL 或 zip 安装第三方技能到 ~/.nova/skills 或项目 .nova/skills
user-invocable: true
argument-hint: "[zip 路径或 https URL]"
---

# 安装技能（skill-add）

你正在执行 **skill-add** 技能，帮助用户从 **zip 包** 或 **URL** 安装技能。

## 工作区

- 路径：<%= workspacePath %>

## 用户参数

```
${arguments}
```

若用户未提供参数，请询问：zip 本地路径、或 `https://` 下载地址，以及安装位置（`global` | `project`）。

## 安装流程

### 方式 A：本地 zip（推荐）

1. 确认 zip 路径存在（`read` 或 `bash` 检查）
2. 解压到临时目录，查找 `SKILL.md`（通常在 `<skill-name>/SKILL.md`）
3. 解析 frontmatter，校验 `name` 与 `description`
4. 目标目录：
   - **global**：`~/.nova/skills/<name>/`
   - **project**：`.nova/skills/<name>/`
5. 复制整个技能目录（含附属文件）到目标路径
6. 若同名已存在，询问是否覆盖

### 方式 B：URL 下载

1. 仅接受 `https://` 链接
2. 下载到临时目录（超时 30s）
3. 按方式 A 第 2–6 步处理

### 方式 C：设置页导入（UI）

提示用户也可在 **设置 → 技能 → 导入** 中拖拽 zip（若 UI 已启用）。

## 安装后验证

1. 列出 `SKILL.md` 的 `name` 与 `description`
2. 建议用户输入 `/技能名` 试用
3. 若解析有 warnings，逐条说明

## 安全与约束

- 不要执行 zip 内未知脚本；仅复制 Markdown 与明确附属文件。
- 不修改用户 Claude Code 源目录（`~/.claude/skills`）；第三方 Claude 技能由应用设置开关只读挂载。
- 安装失败时保留错误信息，不留下半成品目录（或清理空目录）。

## 环境提示

安装全局技能时，路径基于用户主目录下的 `.nova/skills/`。项目级技能仅对当前工作区可见。