构建高质量 Agent Skills 的实操指南,覆盖 SKILL.md 结构、frontmatter、描述写法与单文件 / references/ 取舍。
编程
Agent Skills
试用Agent Skills standard reference guide. Covers SKILL.md specification format, progressive loading, skill discovery and activation, authoring best practices, quality evaluation, description optimization
它能做什么
Agent Skills standard reference guide. Covers SKILL.md specification format, progressive loading, skill discovery and activation, authoring best practices, quality evaluation, description optimization, and more.
技能文档
Agent Skills Standard
A standardized way to equip AI Agents with new capabilities and domain expertise. Adopted by 35+ Agent products.
Use Cases
Use when creating new skills, validating skill formats, optimizing existing skills, or learning about standardized skill system design.
Reference File Routing
| Need | Read |
|---|---|
| Quick skill creation (5-step guide) | quick-start.md |
| SKILL.md format spec + Agent integration | spec.md |
| Authoring best practices + quality eval + description optimization | authoring.md |
| Common anti-patterns and fixes | anti-patterns.md |
| Script binding and design | using-scripts.md |
| Supported product list | products.md |
Minimal Example
---
name: pdf-processing
description: Extract PDF text, fill forms, merge files. Use when handling PDFs.
---
## Workflow
1. Extract: `python scripts/extract.py input.pdf`
2. Fill: `python scripts/fill.py template.pdf data.json`
## Gotchas
- Scanned PDFs need OCR first — use `scripts/ocr.py`
Validation
skills-ref validate ./my-skill
相关技能
Generate Skill skeleton code, SKILL.md, and reference materials following best practices
Create new agent skills with proper structure, progressive disclosure, and bundled resources. Use when user wants to create, write, or build a new skill.
Agent skill recommender. Input a user need, task description, or existing skill list; output best matching skills, install rationale, duplicate/merge candida...
改任何文件前先看 diff、备份、等用户确认,安全升级已安装的代理技能。
Use when asked to review, edit, tighten, shorten, deduplicate, clean up, or remove slop from an existing agent skill while preserving behavior. Use for skill...