gentle-ai-skill-improver

1## Activation Contract
2 
3Use this skill when auditing, refactoring, normalizing, or improving existing `SKILL.md` files. Use `gentle-ai-skill-creator` when creating a brand-new skill from a reusable pattern.
4 
5## Hard Rules
6 
7- Read `docs/skill-style-guide.md` first and treat it as the normative style contract.
8- Treat `SKILL.md` as the source of truth; preserve author intent, critical rules, activation semantics, and output requirements.
9- Use `.atl/skill-registry.md` as an index of skill names, triggers, scopes, and exact paths when available.
10- Default to audit-only. Modify files only when the user explicitly asks to apply improvements.
11- Never delete meaningful content silently; move long explanation, examples, templates, or schemas into local `references/` or `assets/`.
12- Do not invent triggers, policies, or domain rules. Mark ambiguous cases for human review.
13 
14## Decision Gates
15 
16| Situation | Action |
17| --- | --- |
18| Missing or invalid frontmatter | Fix `name`, quoted one-line `description`, `license`, and `metadata` |
19| Skill reads like tutorial docs | Convert to runtime instructions and move background to `references/` |
20| Body exceeds budget | Preserve rules, move examples/background to supporting files |
21| Branching logic hidden in prose | Convert to a compact decision table |
22| Rules conflict or intent is unclear | Report the issue; do not rewrite that rule automatically |
23 
24## Execution Steps
25 
261. Read `docs/skill-style-guide.md`.
27…