Skill Dedup Scanner

扫描指定目录下已安装的 Skill，比对名称与描述的相似度，按阈值标记高、中、低相似度冲突，输出分析报告与处理建议，支持英文、中文界面以及 JSON 输出。运行需 Python 3 与 PyYAML。

shyjsarah

热度 46.69

最近更新 2026-05-11 17:33:24

分类：开发依赖：代码执行 / 读写文件应用场景：报告撰写 / 自动化脚本 / 工作流

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add skill-dedup-scanner

Metadata

name: skill-dedup-scanner
description: Scans installed skills for duplicates and naming conflicts. Detects similar skills that may cause model confusion. Use before publishing new skills or when troubleshooting trigger conflicts. Supports English and Chinese (auto-detect or --lang flag).

Skill Dedup Scanner 🔍

Detects duplicate or similar skills that may cause model confusion.

When to Use

Before publishing a new skill
When skills trigger incorrectly
Auditing existing skill collection
Resolving naming conflicts
Checking for similar skill names/descriptions

Usage

Basic Scan

# Auto-detect language
python3 scripts/main.py ~/.openclaw/workspace/skills/

# Specify language
python3 scripts/main.py ~/.openclaw/workspace/skills/ --lang en
python3 scripts/main.py ~/.openclaw/workspace/skills/ --lang zh

Advanced Options

# Custom threshold (0-1)
python3 scripts/main.py ~/.openclaw/workspace/skills/ --threshold 0.8

# Output to file
python3 scripts/main.py ~/.openclaw/workspace/skills/ -o audit_report.md

# JSON output
python3 scripts/main.py ~/.openclaw/workspace/skills/ --json

# Verbose mode
python3 scripts/main.py ~/.openclaw/workspace/skills/ -v

Options

Option	Short	Description	Default
`--lang`	`-l`	Language: en, zh, auto	auto
`--threshold`	`-t`	Similarity threshold (0-1)	0.7
`--output`	`-o`	Output file path	stdout
`--json`	`-j`	Output in JSON format	false
`--verbose`	`-v`	Verbose output	false

Output

Generates a detailed report with:

Similarity scores (name + description)
Conflict analysis
Actionable recommendations
List of safe/unique skills

Similarity Thresholds

Score	Level	Action
> 0.85	🔴 High	Consider merging or renaming
0.7-0.85	🟡 Medium	Clarify descriptions
< 0.7	✅ Safe	No action needed

Language Support

English (--lang en)
Chinese (--lang zh)
Auto-detect (--lang auto) - Detects system locale

Examples

Example 1: Quick Scan

$ python3 scripts/main.py ~/.openclaw/workspace/skills/
🔍 Scan Directory: /home/user/.openclaw/workspace/skills
📦 Total Skills: 15

✅ No Duplicate Skills Found

All skills have distinct names and descriptions. No optimization needed.

Example 2: Find Conflicts

$ python3 scripts/main.py ~/.openclaw/workspace/skills/ --threshold 0.6
🔍 Scan Directory: /home/user/.openclaw/workspace/skills
📦 Total Skills: 15

⚠️ Found 2 Groups of Similar Skills

### 1. 🔴 High Similarity Warning

**Skill A:** `tushare-finance`
**Skill B:** `stock-analyzer`

**Similarity Score:** 85%

**Analysis:**
- Name Similarity: 60%
- Description Similarity: 85%

**Recommendations:**
- Clarify the distinction in descriptions
- Rename to make purposes more distinct

Project Structure

skill-dedup-scanner/
├── scripts/
│   ├── main.py                 # Main entry point
│   ├── skill_scanner.py        # Skill scanner
│   ├── similarity_checker.py   # Similarity calculator
│   ├── report_generator.py     # Report generator
│   └── locale_loader.py        # Multi-language support
├── locales/
│   ├── en.json                 # English translations
│   └── zh.json                 # Chinese translations
├── references/
│   └── best_practices.md       # Skill naming best practices
└── output/                     # Generated reports

Requirements

Python 3.7+
PyYAML (pip install pyyaml)

License

MIT