# skill-scanner

> 扫描 GitHub 仓库或本地目录，发现符合 Anthropic 标准的 Skills，与本地 Skills 库进行对比，并支持一键安装新技能。适用于发现和引入新的 Agent 能力。

- Author: 辜腾玉
- Repository: ClairKu/skills
- Version: 20260125153824
- Stars: 0
- Forks: 0
- Last Updated: 2026-02-06
- Source: https://github.com/ClairKu/skills
- Web: https://mule.run/skillshub/@@ClairKu/skills~skill-scanner:20260125153824

---

---
name: skill-scanner
description: 扫描 GitHub 仓库或本地目录，发现符合 Anthropic 标准的 Skills，与本地 Skills 库进行对比，并支持一键安装新技能。适用于发现和引入新的 Agent 能力。
version: 1.1.0
author: Clair
---
该技能用于发现、对比和安装新的 Skills。遵循 Anthropic 的 Skill 结构规范（包含 `SKILL.md` 的目录）。

## 使用场景

当你想从外部仓库（如 `anthropics/skills` 或其他开源仓库）引入新技能，或者整理现有的技能库时使用。

## 核心功能

1. **扫描 (Scan)**: 给定一个 Git URL 或本地路径，递归查找所有包含 `SKILL.md` 的子目录。
2. **对比 (Compare)**: 将扫描到的技能与当前 Workspace 中的 `skills/` 目录进行对比，识别：
   * **New**: 本地不存在的技能。
   * **Existing**: 本地已存在的技能。
3. **安装 (Install)**: 允许用户选择性地将新技能复制到本地 `skills/imported/` 或指定目录。

## 使用方法

### 1. 扫描并交互式安装

在终端中运行脚本（支持从任何位置运行）：

```bash
python3 path/to/skill-scanner/scripts/scan_and_install.py --url <GIT_REPO_URL>
```

工具会自动：

1. 向上查找项目根目录（寻找 `.git` 或 `skills` 目录）。
2. 扫描项目中的 `skills` 目录以识别现有技能。
3. 默认将新技能安装到 `skills/other_skills` 目录下，并根据技能名称和描述自动分类（如 `agent-engineering`, `software-development` 等）。如果无法分类，将尝试根据名称前缀创建新分类或放入 `uncategorized`。

你可以通过参数禁用自动分类或自定义路径：

```bash
# 禁用自动分类，指定目标目录
python3 scripts/scan_and_install.py \
  --url <GIT_REPO_URL> \
  --target-dir ./my-skills/new-stuff

# 禁用自动分类，默认安装到 skills/imported
python3 scripts/scan_and_install.py \
  --url <GIT_REPO_URL> \
  --no-auto-cat
```

### 2. 仅扫描并生成报告

```bash
python3 scripts/scan_and_install.py --url <GIT_REPO_URL> --report-only
```

## 依赖

* Python 3
* Git (如果扫描远程仓库)
* Standard libraries (os, re, shutil, subprocess, tempfile, json)