skilldex-cli 中文 description（草稿）

技能简介

Skilldex（npm 包名 skilldex-cli，命令名 skillpm / spm）是 Claude Skill 领域的专用包管理器，定位为"npm but for Claude skills"。它负责 Claude .skill 格式包的安装、格式验证、质量评分、AI 技能推荐，并原生集成 Claude Code、Codex 及所有支持 MCP 的编码 Agent。

核心能力

1. Skill 包安装与管理：支持从本地路径、GitHub 简写、全量 Git URL、GitLab 安装 Skill 包，自动识别并写入正确作用域（global / shared / project）。
2. 格式验证（compiler-style feedback）：逐字段校验 YAML frontmatter、name 字段、description 长度、SKILL.md 行数、bundled resources 路径，输出精确到行号的错误提示。
3. 质量评分（Quality Scoring）：对 Skill 包打分（Format Conformance Score），告诉用户该 Skill 是否符合 Anthropic 官方规范。
4. AI 驱动的技能推荐：内置 AI 推荐引擎，根据用户项目上下文推荐合适的 Skill。
5. 多平台安装支持：支持 npm（全平台）、Homebrew（macOS/Linux）、curl 一键安装（macOS/Linux）、Scoop（Windows）以及源码编译。
6. 与编码 Agent 原生集成：Skilldex 验证后的 Skill 可直接被 Claude Code、Codex 等 Agent 识别使用，无需手动配置 MCP。
7. MCP 集成：Skilldex 是 MCP 兼容的包管理器，可与所有支持 MCP 协议的 Agent 无缝对接。
8. 双重命令别名：skillpm 和 spm 为同一命令的两种命名，用户可自由选择。

安装配置

方式一：npm（全平台推荐）

npm install -g skilldex-cli

方式二：Homebrew（macOS / Linux）

brew tap pandemonium-research/skilldex
brew install skilldex-cli

方式三：curl 一键安装（macOS / Linux）

curl -fsSL https://skilldex-web.vercel.app/install.sh | sh

方式四：Scoop（Windows）

scoop bucket add skilldex https://github.com/Pandemonium-Research/scoop-skilldex
scoop install skilldex-cli

方式五：源码编译

git clone https://github.com/Pandemonium-Research/Skilldex.git
cd Skilldex
npm install
npm run build
npm link

安装完成后，skillpm 和 spm 两个命令均可用（功能完全相同）。

使用步骤

第一步：验证本地 Skill 包

安装一个 Skill 之前，可以先验证其格式是否合规：

skillpm validate ./my-skill

验证器会逐项检查 YAML frontmatter、name、description 长度、SKILL.md 完整性、assets 目录，输出格式类似编译器错误报告，并给出综合评分（满分 100）。

第二步：安装 Skill

从本地路径或 GitHub 安装 Skill 到指定作用域：

# 从本地路径安装（项目级别）
skillpm install ./forensics-agent --scope project

# 从 GitHub 安装（项目级别）
skillpm install git+https://github.com/user/forensics-agent --scope project

# 从仓库子目录安装
skillpm install git+https://github.com/user/skills-collection/tree/main/forensics-agent

--scope 支持三种级别：project（仅当前项目）、shared（同机器多项目共享）、global（全局）。

第三步：列出已安装的 Skill

skillpm list

输出会按作用域分组显示已安装的 Skill 及其评分。

第四步：在编码 Agent 中使用

Skilldex 验证通过的 Skill 可被 Claude Code、Codex、Cursor 等 Agent 直接使用。安装时 Skilldex 自动处理 MCP 配置，Agent 无需额外设置即可识别该 Skill。

适用场景

1. 多项目管理：在 project scope 下安装 Skill，各项目 Skill 配置互不干扰。
2. 团队共享：在 shared scope 下安装团队统一维护的 Skill，所有项目共享。
3. 个人工具库：在 global scope 下安装个人常用 Skill，所有项目自动获得。
4. Skill 开发与调试：开发者发布 Skill 前先用 skillpm validate 自检格式，确保符合 Anthropic 规范。
5. Skill 质量审计：通过质量评分判断一个 Skill 是否值得信赖，评分低于 60 分的包通常存在格式或内容问题。
6. 编码 Agent 扩展：为 Claude Code / Codex 等 Agent 快速注入新技能，无需手动编辑 MCP 配置文件。

适用人群

• Claude Code / Codex 用户：希望快速扩展 Agent 能力的开发者。
• Skill 开发者：发布前需验证格式合规性的 Skill 作者。
• AI 工具链管理员：为团队维护统一 Skill 库的技术负责人。
• AI 应用集成工程师：需要将 Claude Skill 能力集成到自有平台的用户。

工作原理

Skilldex 的核心是一个 Skill 包格式验证器 + MCP 集成层。

格式验证器读取 Skill 包的 YAML frontmatter（name、description、version 等字段）、SKILL.md 内容、assets 目录结构，按照 Anthropic 官方 Skill 规范逐项打分。验证通过后，包被写入对应作用域的 Skill 目录，Agent 启动时自动扫描该目录并加载可用 Skill。

MCP 集成层负责将 Skill 暴露为 Agent 可调用的工具。Skilldex 本身不定义 Skill 格式（格式规范由 Anthropic 制定），而是在此基础上提供分发和验证工具层。

官方链接

• npm：https://www.npmjs.com/package/skilldex-cli
• GitHub：https://github.com/Pandemonium-Research/Skilldex
• 官网安装脚本：https://skilldex-web.vercel.app/install.sh