Agent Skills in 7 Days: Turn Experience Into Reusable Capability
Course questions · 21 / 21
D1 What Skills Are: the SKILL.md Spec, Directory Layout, and Three-Stage Progressive Disclosure
What problem do Agent Skills solve, and how are they different from putting every convention into one big instruction file?Agent Skills 解决的是什么问题?它和把所有规范写进一个大的提示词文件有什么区别?
Common in ChinaCommon overseasBasic#agent-skills#context-engineering🔒 Unlock D1 to see the answer keys.
What does each of the three progressive disclosure stages load, and why not just load every skill up front?渐进式加载的三个阶段分别加载什么?为什么不能一次性把所有 skill 全加载进去?
Common in ChinaCommon overseasIntermediate#agent-skills#progressive-disclosure🔒 Unlock D1 to see the answer keys.
What hard constraints does the spec put on the name and description fields, and why is name so tightly constrained?SKILL.md 的 name 与 description 有哪些硬性约束?规范为什么要把 name 卡得这么死?
Common in ChinaCommon overseasIntermediate#agent-skills#spec🔒 Unlock D1 to see the answer keys.
D2 Writing Your First Skill: How to Write description's Trigger Words, How to Layer the Structure, How to Install It Into a Client
What goes wrong when a skill description is too broad, and what goes wrong when it is too narrow? How do you find the middle?skill 的 description 写得太泛会怎样?太窄又会怎样?你怎么找到中间那个点?
Common in ChinaCommon overseasIntermediate#agent-skills#skill-description🔒 Unlock D2 to see the answer keys.
What belongs in a skill body and what does not, and why must the gotchas stay in SKILL.md rather than move to a reference file?skill 的正文应该写什么、不应该写什么?为什么「坑」那一段必须留在 SKILL.md 里而不是挪到引用文件?
Common in ChinaCommon overseasIntermediate#agent-skills#skill-authoring🔒 Unlock D2 to see the answer keys.
How should a client resolve a name collision between a project-level and a user-level skill, and why do clients differ here?项目级和用户级的 skill 同名时该怎么处理?为什么各家客户端在这一点上会有不同的选择?
Common in ChinaCommon overseasDeep dive#agent-skills#client-integration🔒 Unlock D2 to see the answer keys.
D3 A Design Method: Distilling From Repeated Tasks, Checklist Style vs. Reference-Manual Style, Four Anti-Patterns, and Trigger Testing
Which tasks are worth turning into a skill and which are not? Give me a test I can apply on the spot.什么样的任务适合做成 skill,什么样的不适合?给我一套能当场用的判断标准。
Common in ChinaCommon overseasBasic#agent-skills#skill-design🔒 Unlock D3 to see the answer keys.
How do you evaluate whether a skill description is good? Is trying a few prompts yourself enough?怎么测一个 skill 的 description 好不好?自己试几句话够吗?
Common in ChinaCommon overseasIntermediate#agent-skills#evaluation🔒 Unlock D3 to see the answer keys.
When optimizing a description, how do you avoid overfitting to the very queries you wrote?优化 description 的时候怎么避免过拟合到你自己写的那几条测试查询?
Common in ChinaCommon overseasDeep dive#agent-skills#evaluation🔒 Unlock D3 to see the answer keys.
D4 Skills With Scripts: Executable Attachments, Dependencies and Sandboxing, Cross-Platform Support, and Breaking Down Document-Handling Skills
Which logic belongs in a skill's scripts directory and which belongs in the SKILL.md body?什么逻辑该写成脚本放进 skill 的 scripts 目录,什么该留在 SKILL.md 正文里?
Common in ChinaCommon overseasBasic#agent-skills#scripts🔒 Unlock D4 to see the answer keys.
How does designing a command-line script for an agent differ from designing one for a human?给 Agent 用的命令行脚本,接口设计上和给人用的有什么不同?
Common in ChinaCommon overseasIntermediate#agent-skills#scripts#cli-design🔒 Unlock D4 to see the answer keys.
What security risks come with bundling scripts in a skill, how would you contain them, and why should document tasks follow plan, validate, then execute?skill 里带脚本会带来哪些安全风险?你会怎么限制它?另外,为什么文档处理这类任务要先规划再校验后执行?
Common in ChinaCommon overseasDeep dive#agent-skills#security#workflow-design🔒 Unlock D4 to see the answer keys.
D5 Hand-Building a Skill Runtime: Scanning, Frontmatter Parsing, Injecting the System Prompt, Reading the Body on Demand
If you implemented skill support in your own agent, what happens in the discovery stage versus the activation stage, and why split them?如果让你自己给一个 Agent 实现 skill 支持,发现阶段和激活阶段各要做什么?为什么要分成两步?
Common in ChinaCommon overseasIntermediate#agent-skills#runtime#progressive-disclosure🔒 Unlock D5 to see the answer keys.
When your runtime parses a SKILL.md that violates the spec, do you refuse to load it or degrade gracefully? And how do you handle a name collision across scopes?你的运行时解析到一份不合规范的 SKILL.md,是拒绝加载还是降级加载?另外,两个作用域里有同名 skill 时你怎么处理?
Common in ChinaCommon overseasIntermediate#agent-skills#runtime#error-handling🔒 Unlock D5 to see the answer keys.
Once a skill body is in context, how do you keep it effective across a long session? And would you activate skills by file read or by a dedicated tool?skill 的正文进了上下文之后,长会话里怎么保证它不失效?激活方式上文件读取和专用工具你会选哪个?
Common in ChinaCommon overseasDeep dive#agent-skills#runtime#long-session🔒 Unlock D5 to see the answer keys.
D6 Organizing and Distributing: Plugins and Marketplaces, Versioning and Team Sharing, and the Division of Labor Between Function Calling, MCP, and Skills
How do function calling, MCP and Agent Skills relate, and when do you use which?函数调用、MCP 和 Skills 三者的关系是什么?什么时候用哪个?
Common in ChinaCommon overseasIntermediate#agent-skills#mcp#tool-calling#architecture🔒 Unlock D6 to see the answer keys.
A team needs to share more than a dozen skills. How would you organize and distribute them?一个团队要共享十几个 skill,你会怎么组织和分发?
Common in ChinaCommon overseasIntermediate#agent-skills#distribution#team-governance🔒 Unlock D6 to see the answer keys.
Should a skill package be versioned, and what goes wrong most often on upgrade?skill 包要不要做版本管理?升级时最容易出什么问题?
Common in ChinaCommon overseasDeep dive#agent-skills#versioning#distribution🔒 Unlock D6 to see the answer keys.
D7 Capstone and Retrospective: Turning a Team's Conventions Into a Skill Pack and Driving a Subagent Through a Real Task
How do you prove a skill actually helps rather than just feeling better?你怎么证明一个 skill 真的有用,而不是感觉上更好?
Common in ChinaCommon overseasDeep dive#agent-skills#evaluation#methodology🔒 Unlock D7 to see the answer keys.
How many skills should a thirty-page team convention document become, and how do you split it?一份三十页的团队规范文档要拆成几个 skill,按什么切?
Common in ChinaCommon overseasIntermediate#agent-skills#design#decomposition🔒 Unlock D7 to see the answer keys.
What is the difference between running a task in a subagent with skills and running it in the main session?让子代理带着 skill 去执行任务,和在主会话里执行有什么区别?
Common in ChinaCommon overseasDeep dive#agent-skills#subagent#evaluation🔒 Unlock D7 to see the answer keys.