skill-authoring

1# Skill Authoring
2 
3Create and refine reusable agent skills with better trigger quality, cleaner structure, stronger behavioral guidance, and more reliable evaluation.
4 
5## When to use this skill
6 
7Use this skill when you need to:
8 
9- Create a new `SKILL.md`
10- Improve an existing skill's `name` or `description`
11- Review whether a skill is too broad, too narrow, or poorly structured
12- Audit a local skill collection such as `config/source/skills` for redundancy, trigger overlap, or weak boundaries
13- Split a large skill into `SKILL.md` plus `references/`, `assets/`, or `scripts/`
14- Design evaluation prompts and review whether a skill triggers and behaves correctly
15 
16## Repo-managed CloudBase skill review
17 
18When the task targets `config/source/skills`, apply these guardrails in addition to the normal skill-authoring workflow:
19 
20This section is the repo-managed CloudBase skill review baseline for this repository.
21 
22- Keep frontmatter complete and normalized, including `version`
23- Keep examples inside the skill's declared platform and scope
24- Keep shared operational rules in one canonical source instead of copying large blocks across neighboring skills
25- If the skill claims a rule is mandatory, show that rule in at least one example
26- When giving a recommended default, also explain the tradeoff behind it
27…