S
SkillsMD 发现、学习和掌握最新的 AI 技术 Skills。基于真实社区数据，为开发者提供最权威的 AI 工具导航。
关于 聚焦 AI 技术 Skills 每周数据更新 中英双语文档 © 2026 SkillsMD. All rights reserved.
Agent Skills (agentskills.io) - 为AI智能体创建可移植技能的规范与工具 | SkillsMD
首页 / Skills / agentskills-io Agent Skills (agentskills.io) - 为AI智能体创建可移植技能的规范与工具 agentskills-io by codexclawd/codexclawd
npx skills add https://github.com/codexclawd/codexclawd --skill agentskills-io🇨🇳 中文介绍 Agent Skills (agentskills.io)
为 AI 智能体创建可移植的技能。兼容 Claude Code、Cursor、GitHub Copilot、OpenAI 集成、VS Code（符号链接支持跨工具共享）。
资源
结构
skill-name/
├── SKILL.md # 必需（前置元数据 + 指令，激活时 <5000 tokens）
├── scripts/ # 可选：可执行代码
├── references/ # 可选：详细文档
└── assets/ # 可选：模板、静态文件
规则 ：目录名 = 前置元数据中的 name:。仅允许 3 个子目录。SKILL.md 文件 <500 行。用于发现的 token 数约 100（名称+描述）。
前置元数据
必需项
name: 1-64 个字符，小写字母数字和连字符（^[a-z0-9]+(-[a-z0-9]+)*$）description: 1-1024 个字符，需包含 "Use when..."（发现预算：约 100 tokens）
可选项
🇺🇸 English Agent Skills (agentskills.io)
Create portable skills for AI agents. Works with Claude Code, Cursor, GitHub Copilot, OpenAI integrations, VS Code (symlinks enable sharing across tools).
Resources
Structure
skill-name/
├── SKILL.md # Required (frontmatter + instructions, <5000 tokens activation)
├── scripts/ # Optional: executable code
├── references/ # Optional: detailed docs
└── assets/ # Optional: templates, static files
Rules : Dir name = frontmatter name:. Only 3 subdirs. SKILL.md <500 lines. ~100 tokens for discovery (name+desc).
Frontmatter
Required
name: 1-64 chars, lowercase alphanumeric-hyphens (^[a-z0-9]+(-[a-z0-9]+)*$)
广告位招租
在这里展示您的产品或服务
触达数万 AI 开发者，精准高效
联系我们
license: SPDX 标识符（Apache-2.0, MIT）| compatibility: 环境要求（<500 字符）metadata: 键值对（作者、版本、标签）| allowed-tools: 空格分隔的工具列表
验证 # 永久安装（对比临时性的 uvx）
uv tool install git+https://github.com/agentskills/agentskills#subdirectory=skills-ref
# 或使用 uvx 进行一次性验证
uvx --from git+https://github.com/agentskills/agentskills#subdirectory=skills-ref skills-ref validate ./skill
命令 描述 skills-ref validate <路径>检查结构、前置元数据、token 预算 skills-ref read-properties <路径>提取元数据 skills-ref to-prompt <路径>生成提示词格式
编写规则
使用祈使句语言："检查：command"，而非 "你可能想..."
提供包含预期输出的具体示例；针对常见错误提供解决方案
渐进式披露：核心内容在 SKILL.md 中（<5000 tokens），详细信息在 references/ 目录下
常见错误 错误 修复方法 名称无效 仅允许小写字母数字和连字符 缺少描述 添加包含 "Use when..." 的 description: 字段 描述过长 <1024 字符，将细节移至正文 YAML 无效 检查缩进，为特殊字符添加引号 缺少 SKILL.md 文件名必须为 SKILL.md 目录名不匹配 目录名必须与 name: 字段一致
快速工作流
创建：mkdir skill-name && touch skill-name/SKILL.md
添加前置元数据（名称、包含 "Use when..." 的描述）
编写指令（使用项目符号，而非散文）；验证：skills-ref validate ./skill-name
使用 AI 智能体测试，迭代改进；添加 LICENSE，推送至仓库
插件结构（Claude Code） plugin-name/
├── .claude-plugin/plugin.json
├── README.md, LICENSE, CHANGELOG.md # CHANGELOG.md 记录版本
├── skills/skill-name/SKILL.md
├── agents/ # 可选：子智能体（.md 文件）
└── examples/ # 可选：完整演示项目
区别 ：插件的 examples/ = 可运行项目。技能的 assets/ = 仅限静态资源。
批量验证与版本管理 bash scripts/validate-skills-repo.sh # 验证仓库中的所有技能
bash scripts/bump-changed-plugins.sh # 自动仅更新已更改插件的版本（语义化版本）
最小示例 ---
name: example-skill
description: 简要描述。在需要做 X 时使用。
---
# 示例技能
## 先决条件
- 必需的工具
## 指令
1. 第一步：`command`
2. 第二步及示例
## 故障排除
**错误**：消息 → **修复**：解决方案
符号链接共享 在 Claude Code、Cursor、VS Code 之间共享技能：ln -s /path/to/skills ~/.cursor/skills
参考文档
description: 1-1024 chars, include "Use when..." (discovery budget: ~100 tokens)
Optional
license: SPDX identifier (Apache-2.0, MIT) | compatibility: Environment reqs (<500 chars)metadata: Key-value pairs (author, version, tags) | allowed-tools: Space-delimited tool list
Validation # Install permanently (vs ephemeral uvx)
uv tool install git+https://github.com/agentskills/agentskills#subdirectory=skills-ref
# Or use uvx for one-shot validation
uvx --from git+https://github.com/agentskills/agentskills#subdirectory=skills-ref skills-ref validate ./skill
Command Description skills-ref validate <path>Check structure, frontmatter, token budgets skills-ref read-properties <path>Extract metadata skills-ref to-prompt <path>Generate prompt format
Writing Rules
Imperative language: "Check: command" not "You might want to..."
Concrete examples with expected output; handle common errors with solutions
Progressive disclosure: core in SKILL.md (<5000 tokens), details in references/
Common Errors Error Fix Invalid name Lowercase alphanumeric-hyphens only Missing description Add description: field with "Use when..." Description too long <1024 chars, move details to body Invalid YAML Check indentation, quote special chars Missing SKILL.md Filename must be exactly SKILL.md Dir name mismatch Directory name must match name: field
Quick Workflow
Create: mkdir skill-name && touch skill-name/SKILL.md
Add frontmatter (name, description with "Use when...")
Write instructions (bullets, not prose); validate: skills-ref validate ./skill-name
Test with AI agent, iterate; add LICENSE, push to repository
Plugin Structure (Claude Code) plugin-name/
├── .claude-plugin/plugin.json
├── README.md, LICENSE, CHANGELOG.md # CHANGELOG.md tracks versions
├── skills/skill-name/SKILL.md
├── agents/ # Optional: subagents (.md files)
└── examples/ # Optional: full demo projects
Distinctions : Plugin examples/ = runnable projects. Skill assets/ = static resources only.
Batch Validation & Versioning bash scripts/validate-skills-repo.sh # Validate all skills in repo
bash scripts/bump-changed-plugins.sh # Auto-bump only changed plugins (semver)
Minimal Example ---
name: example-skill
description: Brief description. Use when doing X.
---
# Example Skill
## Prerequisites
- Required tools
## Instructions
1. First step: `command`
2. Second step with example
## Troubleshooting
**Error**: Message → **Fix**: Solution
Symlink Sharing Share skills across Claude Code, Cursor, VS Code: ln -s /path/to/skills ~/.cursor/skills
References agent-browser 浏览器自动化工具 - Vercel Labs 命令行网页操作与测试
147,400 周安装
