---

name: skill-authoring description: > For this repository, use when creating, reviewing, or packaging Agent Skills (SKILL.md, scripts/, references/, assets/). Enforces naming rules, folder layout, and provides a validation checklist before upload/commit. allowed-tools:

• Read
• Write
• Bash

---

skill-authoring (Project Skill)

Global Rule (CRITICAL)

For any task involving creation, review, or packaging of skills in this repository, you MUST read and follow references/STYLE_GUIDE.md before taking any action.

If scripts/validate_skill.py exists in the target skill directory, you MUST read and understand that script before performing validation.

---

Instructions

When the user asks to create or modify a Skill in this repo, do ALL of the following steps in order. Do not skip any step.

1) Choose a valid skill name

• lowercase + hyphens only, <= 64 chars
• directory name MUST match name in SKILL.md

---

2) Generate the canonical folder structure

• Always create: skill-name/SKILL.md
• Optionally add: scripts/, references/, assets/ when needed
• Keep references shallow (prefer one-level file references)

---

3) Write SKILL.md with progressive disclosure

• YAML frontmatter MUST include: name, description

• Body MUST contain concise steps + examples + edge cases

• Before writing or editing any SKILL.md, you MUST read and follow references/STYLE_GUIDE.md.

• If the skill includes any automation scripts, you MUST reference them using relative paths such as scripts/validate_skill.py and explain when they are used.

---

4) Run validation before finishing

• If scripts/validate_skill.py exists, execute:

  Copypython scripts/validate_skill.py <path-to-skill>