skill-awesome

When to use this skill

ALWAYS use this skill when you need to know:

• What the Agent Skills specification requires (directory structure, SKILL.md format, frontmatter fields)
• What naming conventions to follow for a skill (name must match directory, lowercase + hyphens only, etc.)
• What frontmatter fields are required vs optional, and their constraints
• What progressive disclosure means and how to structure a skill to use it
• What the official best practices say about scope, context budgeting, gotchas, and checklists
• How to write a good description that triggers reliably
• What script safety rules apply (non-interactive, --help, no secrets, structured output)
• How the TRACE evaluation framework judges skill quality
• What a well-structured skill looks like (reference examples)
• "设计技能" (design a skill), "创建技能" (create a skill), "技能规范" (skill specification)
• "技能命名规则" (skill naming rules), "技能命名规范" (skill naming conventions)
• "SKILL.md 怎么写" (how to write SKILL.md), "frontmatter 规范" (frontmatter specification)
• "技能最佳实践" (skill best practices), "技能目录结构" (skill directory structure)
• "渐进式披露" (progressive disclosure), "Agent Skills 规范" (Agent Skills spec)
• "怎么写 description" (how to write description), "skill description 怎么写"
• "技能脚本安全" (skill script safety), "技能触发条件" (skill trigger conditions)

Trigger phrases include:

• "我要设计一个新的 Skill，告诉我规范" (I want to design a new skill, tell me the spec)
• "SKILL.md 的 frontmatter 有哪些字段" (what fields are in SKILL.md frontmatter)
• "技能的 name 有什么命名规则" (what are the naming rules for skill name)
• "怎么让技能的 description 触发更准确" (how to make skill description trigger more accurately)
• "技能的最佳实践有哪些" (what are the best practices for skills)
• "渐进式披露怎么用" (how to use progressive disclosure)
• "设计一个 Skill 需要注意什么" (what to pay attention to when designing a skill)
• "tell me the Agent Skills specification", "what makes a good skill"
• "how should I structure a skill directory", "skill frontmatter rules"

1. Agent Skills Specification