skills-manager

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Skills Manager

Unified skill lifecycle management across agents.

跨Agent的统一skill生命周期管理。

Usage

使用方法

/skills-manager                    # Quick status overview
/skills-manager list               # All skills with origin, description, agent
/skills-manager search <query>     # Search skills.sh ecosystem
/skills-manager install <source>   # Install from ecosystem or GitHub
/skills-manager remove <name>      # Remove a skill
/skills-manager inspect <name>     # Deep-read: frontmatter, scripts, structure
/skills-manager validate [path]    # Validate structure and frontmatter
/skills-manager audit              # System-wide health check
/skills-manager update             # Check and apply ecosystem updates
/skills-manager create             # Guided creation (delegates to skill-creator)

/skills-manager                    # 快速查看状态概览
/skills-manager list               # 查看所有skills及其来源、描述、所属Agent
/skills-manager search <query>     # 搜索skills.sh生态系统中的skills
/skills-manager install <source>   # 从生态系统或GitHub安装skill
/skills-manager remove <name>      # 移除一个skill
/skills-manager inspect <name>     # 深度查看：前置元数据、脚本、结构
/skills-manager validate [path]    # 验证skill的结构和前置元数据
/skills-manager audit              # 系统级健康检查
/skills-manager update             # 检查并应用生态系统的skill更新
/skills-manager create             # 引导式创建（委托给skill-creator）

Status (/skills-manager)

状态查看 (/skills-manager)

Quick overview of all installed skills.

bash

bun ~/.claude/skills/skills-manager/scripts/manage.ts status

Shows: total count, breakdown by origin (local/ecosystem/symlink) and agent, lock file stats, validation issue count.

快速查看所有已安装skills的概览信息。

bash

bun ~/.claude/skills/skills-manager/scripts/manage.ts status

显示内容：总数量、按来源（本地/生态系统/符号链接）和Agent的分类统计、锁定文件状态、验证问题数量。

List (/skills-manager list)

列出Skills (/skills-manager list)

All installed skills across agents with metadata.

Local skills:

bash

bun ~/.claude/skills/skills-manager/scripts/manage.ts list

Ecosystem skills (via npx):

bash

npx skills list -g

Present both outputs together — local list shows origin/agent/description, ecosystem list shows remote registry state.

查看所有Agent上已安装的skills及其元数据。

本地skills：

bash

bun ~/.claude/skills/skills-manager/scripts/manage.ts list

生态系统skills（通过npx）：

bash

npx skills list -g

将两个输出结果合并展示——本地列表显示来源/所属Agent/描述，生态系统列表显示远程注册表状态。

Search (/skills-manager search <query>)

搜索Skills (/skills-manager search <query>)

Search the skills.sh ecosystem for installable skills.

bash

npx skills find <query>

Present results with name, source, and install command. If no results, suggest

npx skills find

(interactive mode) or creating a custom skill.

在skills.sh生态系统中搜索可安装的skills。

bash

npx skills find <query>

展示结果包含名称、来源和安装命令。如果没有搜索结果，建议使用

npx skills find

（交互式模式）或创建自定义skill。

Install (/skills-manager install <source>)

安装Skill (/skills-manager install <source>)

Install a skill from the ecosystem or GitHub.

bash

npx skills add <source> -g -y

Source formats:

```
owner/repo@skill-name
```
— from skills.sh registry
```
https://github.com/owner/repo
```
— from GitHub directly
Local path — for development

The

-g

flag installs globally (user-level),

-y

skips confirmation.

After install, run validate to confirm the skill is well-formed:

bash

bun ~/.claude/skills/skills-manager/scripts/manage.ts validate ~/.agents/skills/<name>

从生态系统或GitHub安装skill。

bash

npx skills add <source> -g -y

来源格式：

```
owner/repo@skill-name
```
— 来自skills.sh注册表
```
https://github.com/owner/repo
```
— 直接来自GitHub
本地路径 — 用于开发环境

-g

标志表示全局安装（用户级别），

-y

标志跳过确认步骤。

安装完成后，运行验证命令确认skill格式合规：

bash

bun ~/.claude/skills/skills-manager/scripts/manage.ts validate ~/.agents/skills/<name>

Remove (/skills-manager remove <name>)

移除Skill (/skills-manager remove <name>)

Remove an installed skill.

bash

npx skills remove <name> -g -y

移除已安装的skill。

bash

npx skills remove <name> -g -y

Inspect (/skills-manager inspect <name>)

查看Skill详情 (/skills-manager inspect <name>)

Deep-read a specific skill by name.

bash

bun ~/.claude/skills/skills-manager/scripts/manage.ts inspect <name>

Shows: path, origin, agent, symlink target, frontmatter fields, scripts with size and executable status, references directory listing, SKILL.md heading structure.

深度查看指定名称的skill详情。

bash

bun ~/.claude/skills/skills-manager/scripts/manage.ts inspect <name>

显示内容：路径、来源、所属Agent、符号链接目标、前置元数据字段、脚本的大小和可执行状态、引用目录列表、SKILL.md的标题结构。

Validate (/skills-manager validate [path])

验证Skill (/skills-manager validate [path])

Validate skill structure and frontmatter against the spec.

bash

bun ~/.claude/skills/skills-manager/scripts/manage.ts validate <path>

Path can be:

A single skill directory (containing SKILL.md)
A directory of skills (e.g.,
```
~/.claude/skills
```
)

根据规范验证skill的结构和前置元数据。

bash

bun ~/.claude/skills/skills-manager/scripts/manage.ts validate <path>

路径可以是：

单个skill目录（包含SKILL.md文件）
skills目录（例如：
```
~/.claude/skills
```
）

Checks performed

执行的检查项

Errors (blocking):

SKILL.md exists with valid frontmatter
Required fields: name, description
Name: hyphen-case, max 64 chars, no leading/trailing/consecutive hyphens
Description: 50+ chars, max 1024 chars, no angle brackets
No forbidden files (README.md, CHANGELOG.md, etc.)

Warnings:

Non-spec frontmatter keys (origin, inspired-by, hooks, status) — suggest metadata: migration
Unexpected keys beyond spec-allowed set
SKILL.md over 500 lines
Scripts not executable
Broken internal file references

错误（阻止性）：

存在SKILL.md文件且包含有效的前置元数据
必填字段：name、description
名称：连字符格式，最多64个字符，无开头/结尾/连续连字符
描述：50-1024个字符，无尖括号
无禁止文件（README.md、CHANGELOG.md等）

警告：

非规范前置元数据键（origin、inspired-by、hooks、status）——建议迁移到metadata字段
存在规范允许集合之外的意外键
SKILL.md文件超过500行
脚本不可执行
内部文件引用损坏

Audit (/skills-manager audit)

系统审核 (/skills-manager audit)

System-wide health check across all agents.

bash

bun ~/.claude/skills/skills-manager/scripts/manage.ts audit

Runs:

Validation — every skill checked against spec
Symlink health — dead symlinks flagged
Lock file consistency — lock entries with missing directories
Name overlap — same skill name across agents

Returns exit code 1 if any errors found.

跨所有Agent的系统级健康检查。

bash

bun ~/.claude/skills/skills-manager/scripts/manage.ts audit

执行以下检查：

验证 — 每个skill都按照规范检查
符号链接健康状态 — 标记无效符号链接
锁定文件一致性 — 标记锁定条目对应的目录不存在的情况
名称冲突 — 跨Agent的同名skill

如果发现任何错误，返回退出码1。

Update (/skills-manager update)

更新Skill (/skills-manager update)

Check for and apply ecosystem skill updates.

Check for updates:

bash

npx skills check

Apply updates:

bash

npx skills update

检查并应用生态系统中的skill更新。

检查更新：

bash

npx skills check

应用更新：

bash

npx skills update

Create (/skills-manager create)

创建Skill (/skills-manager create)

Delegates to the skill-creator skill for guided 6-step creation.

When user runs

/skills-manager create

Invoke
```
/skill-creator
```
which provides the full guided workflow

After creation, run validate on the new skill:

bash

bun ~/.claude/skills/skills-manager/scripts/manage.ts validate <new-skill-path>

委托给skill-creator skill进行6步引导式创建。

当用户运行

/skills-manager create

时：

调用
```
/skill-creator
```
，它会提供完整的引导式工作流

创建完成后，对新skill执行验证：

bash

bun ~/.claude/skills/skills-manager/scripts/manage.ts validate <new-skill-path>

Cross-Agent Reference

跨Agent参考

Agent	Skills Dir	Lock File
Claude Code	`~/.claude/skills/`	`~/.agents/.skill-lock.json`
Codex	`~/.codex/skills/`	`~/.agents/.skill-lock.json`
Agents CLI	`~/.agents/skills/`	`~/.agents/.skill-lock.json`

All agents share the same lock file. The

npx skills

CLI auto-detects which agents are installed and manages skills for all of them.

Agent	Skills目录	锁定文件
Claude Code	`~/.claude/skills/`	`~/.agents/.skill-lock.json`
Codex	`~/.codex/skills/`	`~/.agents/.skill-lock.json`
Agents CLI	`~/.agents/skills/`	`~/.agents/.skill-lock.json`

所有Agent共享同一个锁定文件。

npx skills

CLI会自动检测已安装的Agent，并为所有Agent管理skills。

Skill Conventions

Skill规范

Frontmatter: name (hyphen-case), description (50-1024 chars), license (Apache-2.0)
Structure: SKILL.md + optional scripts/, references/, assets/
Forbidden: README.md, CHANGELOG.md, INSTALLATION.md, QUICK_REFERENCE.md
Non-spec keys: origin, inspired-by, status, hooks — should migrate to metadata:
WIP skills:
```
wip-
```
directory prefix +
```
status: wip
```
in frontmatter

前置元数据：name（连字符格式）、description（50-1024字符）、license（Apache-2.0）
结构：SKILL.md + 可选的scripts/、references/、assets/目录
禁止文件：README.md、CHANGELOG.md、INSTALLATION.md、QUICK_REFERENCE.md
非规范键：origin、inspired-by、status、hooks — 应迁移到metadata字段
开发中skills：目录前缀为
```
wip-
```
+ 前置元数据中包含
```
status: wip
```