skill-installer

Skill 安装工具（Skill Installer）

本 skill 提供标准化的 skill 安装流程：获取内容 → 安全审查 → 确认安装 → 写入文件。

安装目录：~/.claude/skills/<skill-name>/SKILL.md

---

支持的输入格式

格式	示例
GitHub 路径	owner/repo 或 owner/repo/skill-name
原始文件 URL	https://raw.githubusercontent.com/...
第三方平台 URL	https://skillsmp.com/skills/...
本地文件路径	/path/to/SKILL.md 或本地目录
直接粘贴内容	用户在对话中粘贴了 SKILL.md 的完整内容

---

执行流程

收到安装请求后，严格按顺序执行以下五个阶段。

---

第一阶段：解析来源

根据用户提供的输入，判断来源类型并获取内容：

来源类型 A：GitHub 路径（owner/repo 或 owner/repo/skill-name）

# 1. 获取仓库基本信息
curl -s "https://api.github.com/repos/OWNER/REPO"

# 2. 列出 skills 目录（如果有）
curl -s "https://api.github.com/repos/OWNER/REPO/contents/skills/SKILL_NAME"

# 3. 获取 SKILL.md 原始内容
curl -s "https://raw.githubusercontent.com/OWNER/REPO/main/skills/SKILL_NAME/SKILL.md"
# 如果 main 分支不存在，尝试 master 分支

记录：Stars、最后更新时间、作者、文件列表。

来源类型 B：原始文件 URL

使用 WebFetch 工具直接获取 URL 内容。 记录：域名来源、是否为已知可信平台。

来源类型 C：第三方平台 URL

使用 WebFetch 工具获取内容。 如果 WebFetch 失败（不可访问），立即终止，输出：

❌ 安装终止：无法访问来源 URL，内容不可审查，拒绝安装。
建议：请提供 GitHub 仓库路径或直接粘贴 SKILL.md 内容。

来源类型 D：本地文件路径

使用 Read 工具读取本地 SKILL.md 文件。 如果是目录路径，尝试读取 <路径>/SKILL.md。

来源类型 E：直接粘贴内容

用户已在对话中提供了完整的 SKILL.md 内容，直接进入审查阶段。 记录：来源为"用户直接提供"，无外部来源信息。

---

第二阶段：安全审查（不可跳过）

对获取到的 SKILL.md 内容执行以下审查，任何一条红线触发即终止安装：

🚨 红线检查（触发任意一条 → 立即终止）

逐行扫描 SKILL.md 内容，检查：

□ curl/wget 指向未知域名（非 GitHub/NPM/PyPI 等已知平台）
□ 将数据发送到外部服务器（POST 请求、数据上报）
□ 读取凭证文件：~/.ssh、~/.aws、~/.config、.env、*_key、*_token
□ 读取或修改 MEMORY.md、CLAUDE.md、USER.md 等配置文件
□ 使用 base64 解码后执行
□ eval() 或 exec() 接收外部输入
□ 请求 sudo 或提权操作
□ 读取浏览器 cookies 或 session 数据
□ 混淆代码（大段 base64、压缩代码、hex 编码）
□ 向 IP 地址（非域名）发起网络请求
□ 安装系统级软件包（brew install、apt-get 等）而未明确说明用途

如果触发红线：

❌ 安装终止：发现安全红线
红线类型：[具体描述]
位置：[在 SKILL.md 的哪个部分]
原因：[为什么这是危险的]
建议：请联系 skill 作者确认，或放弃安装。

⚠️ 风险评估（不触发红线则继续，但输出风险等级）

评估以下维度：

• 文件权限：skill 需要读写哪些文件？范围是否合理？
• 网络访问：需要访问哪些外部服务？目的是否清晰？
• 命令执行：执行哪些 shell 命令？是否有潜在风险？
• 来源可信度：作者是否已知？仓库是否有活跃维护？