skill

:::tips Skill 定位

• 人类知识的蒸馏内容
• 程序性记忆
• 知识库
• SOP
• 字典

:::

• agentskills.io
  • 由 Anthropic 推动
• agentskills/agentskills
  • 规范和文档
• skillsmp.com
  • Agent Skills文档和使用指南
• registry
  • https://skills.sh
    • npx skills add <owner/repo>
  • https://context7.com/?tab=skills
    • npx ctx7 skills search pdf
• index
  • https://github.com/openai/skills
  • https://github.com/openclaw/openclaw/tree/main/skills
• 参考
  • What are skills

tip

• claude code 2.1 支持 hot reload skill, 支持 context: fork 让 skill 独立运行
• vercel/ai#11446
  • vercel/ai Add native support for skills
• Cursor Skill
  • https://cursor.com/docs/context/skills
• google-gemini/gemini-cli#15327

/plugin marketplace add anthropics/skills

/plugin install document-skills@anthropic-agent-skills

• .claude/skills/
• .github/skills/
• .codex/skills/
• .gemini/skills/
• Antigravity
  • <workspace-root>/.agent/skills/<skill-folder>/
  • ~/.gemini/antigravity/skills/<skill-folder>/

skill-name/
├── SKILL.md              # 技能主文档说明
├── scripts/              # 技能相关可执行代码或脚本
├── references/           # 技术参考资料与结构化文档
│   ├── REFERENCE.md      # 技术详解说明
│   ├── FORMS.md          # 表单模板或结构化数据格式
│   └── *.md              # 领域相关参考文件
└── assets/               # 模板文件、图片、数据资料等

• Metadata < 100 tokens
• Instructions < 5000 tokens
  • SKILL.md 建议 < 500 lines

---

• Agent Skills
  • SOP 手册，教程
  • 静态知识
• MCP
  • USB 接口，驱动程序
  • 动态能力
• SubAgent
  • 人设，Persona

Awesome

vercel skills

flag	for
-g, --global	将技能安装到全局范围（用户主目录），而非当前项目
-a, --agent <agents>	指定要安装/操作的 Agent 目录（如 cursor, claude-code, * 表示所有）
-s, --skill <skills>	指定仓库中的特定技能进行操作（使用 * 操作所有）
-l, --list	仅列出仓库中可用的技能，不执行安装
-y, --yes	自动确认，跳过所有交互式提示
--copy	强制使用复制文件的方式，而不是默认的符号链接 (symlinking)
--all	--skill '*' --agent '*' -y
--full-depth	即使根目录存在 SKILL.md，也继续搜索所有子目录

# 查看有哪些技能 - bunx 执行更快
bunx skills add wenerme/ai -l

# 直接安装到 ~/.claude/skills ~/.agents/skills
npx skills add wenerme/ai -s agent-browser -a claude-code -g -y
npx skills add wenerme/ai -s chrome-devtools -a claude-code -g -y
npx skills add wenerme/ai -s skill-writer -a claude-code -g -y

# same as
npx skills add https://github.com/vercel/ai --skill ai-sdk

npx skills add https://github.com/vercel-labs/json-render --skill json-render-shadcn

• skills-lock.json
  • 项目维度
• ~/.agents/.skill-lock.json
  • 全局

BayramAnnakov/claude-reflect

• https://github.com/BayramAnnakov/claude-reflect

spec

---
name: my-skill-name
description: A clear description of what this skill does and when to use it
---

<!-- 引用文件方式 -->

See [the reference guide](references/REFERENCE.md) for details.

Run the extraction script:
scripts/extract.py

# My Skill Name

[Add your instructions here that Claude will follow when this skill is active]

## Examples

- Example usage 1
- Example usage 2

## Guidelines

- Guideline 1
- Guideline 2

注入内容

<available_skills>
  <skill>
    <name>pdf-processing</name>
    <description>Extracts text and tables from PDF files, fills forms, merges documents.</description>
    <location>/path/to/skills/pdf-processing/SKILL.md</location>
  </skill>
  <skill>
    <name>data-analysis</name>
    <description>Analyzes datasets, generates charts, and creates summary reports.</description>
    <location>/path/to/skills/data-analysis/SKILL.md</location>
  </skill>
</available_skills>