gentle-ai-skill-creator

1## Activation Contract
2 
3Use this skill when creating or updating a reusable AI skill for Pi or another agent runtime.
4 
5Create a skill when:
6- a workflow or convention is reused across sessions;
7- generic agent behavior needs project-specific constraints;
8- a decision tree helps the agent choose safely;
9- examples, templates, or references would make future execution more reliable.
10 
11Do not create a skill for a one-off task, generic documentation, or rules that belong in code/tests.
12 
13## Hard Rules
14 
15- Follow `docs/skill-style-guide.md` as the normative source for skill structure and style.
16- A skill is an LLM runtime contract, not human-facing docs.
17- Keep `SKILL.md` concise: target 180–450 tokens, max 1000.
18- Use imperative instructions and concrete gates; avoid tutorials and background prose.
19- Frontmatter `description` must be one physical YAML-safe line and include trigger words first.
20- Do not add a `Keywords` section; put essential trigger words in `description`.
21- Put templates, schemas, and generated examples in `assets/`.
22- Put longer rationale or local doc links in `references/`.
23- After changing project skills, refresh the registry with `/skill-registry:refresh` when available.
24 
25## Decision Gates
26 
27| Need | Action |
28| --- | --- |
29| Small reusable behavior | Create `skills/{skill-name}/SKILL.md` only |
30| Templates, schemas, fixtures | Add `skills/{skill-name}/assets/` |
31| Longer explanation or edge cases | Add `skills/{skill-name}/references/` |
32…