55+
核心知识点
11
关键主题
30分钟
核心框架速览
选择你的学习方式
多种学习模式,适合不同场景和习惯
九大核心主题
从标准规范到客户端实现,完整覆盖 agentskills.io 官方文档
基础概念
Agent Skill 是什么、为什么需要、SKILL.md 文件结构与 agentskills.io 开放标准
规范与 YAML 前置字段
name / description / license / compatibility / metadata / allowed-tools 六大字段
三层渐进式披露
Discovery → Activation → Execution 的 token 经济学,500 行/5000 token 建议上限
Quickstart 实战
.agents/skills/ 约定路径、roll-dice 入门示例、VS Code / Claude Code 验证
最佳实践
从真实任务提炼、Gotchas 段落、模板与校验循环、Plan-Validate-Execute 模式
优化 description
Trigger eval 查询、近似陷阱、Train/Validation 切分、避免过拟合的优化循环
评估输出质量
with_skill vs without_skill、断言、LLM 评审、benchmark.json 与 delta 指标
脚本集成
uvx / npx 一键命令、PEP 723 内联依赖、非交互式、结构化输出设计
客户端实现
Discovery 扫描策略、目录优先级、file-read vs 专用工具激活、Context 保护