writing-skills
"在创建或更新SKILL.md文档时使用 - 解释如何以及为何创建技能。"
📖 中文导读:"在创建或更新SKILL.md文档时使用 - 解释如何以及为何创建技能。" 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。
name: writing-skills description: "Use when creating or updating SKILL.md documentation - Explains how and why to create a skill."
Skills are used to for context that may be useful to a coding agent, without bloating LLM context at times theyre not useful.
Skills are only worthwhile if the coding agent fails a task without the skill.
Skills live in /.skills, with each skill having its own directory.
SKILL.md
Front matter
- Match the
nameto the directory name exactly. - Write the
descriptionas "Use when - " in under 30 words and third person. - Quote the description if it includes punctuation that could break YAML.
Markdown body
- Write concise instructions for the skill topic.
- Keep headings and bullet lists structured so readers can scan quickly.
Aditional files
Other files, like scripts or data, may live in the directory and be referenced by the skill.
AGENTS.md
A GitHub Action automatically regenerates the skills list in AGENTS.md.