技能开发

技能简介

技能开发（agentskills-io）是一套用于创建、验证和发布符合 agentskills.io 官方开放标准的 Agent 技能的规范。支持 Claude Code、Cursor、GitHub Copilot、VS Code 等多种工具，通过统一结构实现跨平台兼容。

能做什么

• 创建符合规范的可移植 Agent 技能
• 验证技能结构和元数据
• 理解 Agent Skills 规范
• 将现有文档转换为可移植技能
• 确保跨平台兼容性（Claude、Cursor、Copilot 等）
• 批量验证仓库中的所有技能
• 通过符号链接在工具间共享技能

使用说明

安装 Skill：

通过 ClawHub 安装：

clawhub install agentskills-io

安装验证工具：

永久安装：

uv tool install git+https://github.com/agentskills/agentskills#subdirectory=skills-ref

一次性使用：uvx --from git+https://github.com/agentskills/agentskills#subdirectory=skills-ref skills-ref validate ./skill

技能结构：

技能目录必须包含 SKILL.md（必需），可选 scripts/、references/、assets/。目录名必须与 frontmatter 中的 name 字段一致。

必需 Frontmatter：

• name：1-64 字符，小写字母数字连字符
• description：1-1024 字符，包含 Use when…（约100 tokens 发现预算）

可选 Frontmatter：license（SPDX 标识）、compatibility（环境要求）、metadata（作者、版本、标签）、allowed-tools（工具列表）

验证命令：

skills-ref validate — 检查结构、frontmatter、token 预算

skills-ref read-properties — 提取元数据

skills-ref to-prompt — 生成 prompt 格式

快速工作流：

1. 创建：mkdir skill-name && touch skill-name/SKILL.md

2. 添加 frontmatter（name、带 Use when… 的 description）

3. 编写指令（bullet 列表，非散文）

4. 验证：skills-ref validate ./skill-name

5. 用 AI 代理测试、迭代

6. 添加 LICENSE，推送到仓库

跨工具共享：

ln -s /path/to/skills ~/.cursor/skills

输入与输出

见下方输入与输出表格。

风险提示

• SKILL.md 必须少于 5000 tokens（约500行）
• 目录名必须与 frontmatter name 字段完全匹配
• 描述中的 Use when… 对发现至关重要
• 子目录仅限 scripts/、references/、assets/
• YAML 缩进和特殊字符需正确处理

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/killerapp/agentskills-io/SKILL.md

来源类型：GitHub