When working on this project, load the relevant skill(s) BEFORE writing any code.
Naming convention: gentle-ai-* skills are repo-specific workflow skills. Unprefixed skills are portable writing or work-unit skills and intentionally keep their canonical names.
- Check the trigger column to find skills that match your current task
- Load the skill by reading the SKILL.md file at the listed path
- Follow ALL patterns and rules from the loaded skill
- Multiple skills can apply simultaneously
| Skill | Trigger | Path |
|---|---|---|
issue-creation |
When creating a GitHub issue, reporting a bug, or requesting a feature. | internal/assets/skills/issue-creation/SKILL.md |
gentle-ai-branch-pr |
When creating a pull request, opening a PR, or preparing changes for review. | skills/branch-pr/SKILL.md |
gentle-ai-chained-pr |
When a change is too large for one review, or when creating chained/stacked pull requests. | skills/chained-pr/SKILL.md |
cognitive-doc-design |
When writing docs that must reduce cognitive load for readers or reviewers. | skills/cognitive-doc-design/SKILL.md |
comment-writer |
When drafting human comments, PR feedback, issue replies, or async updates. | skills/comment-writer/SKILL.md |
work-unit-commits |
When splitting implementation work into deliverable commits or chained PRs. | skills/work-unit-commits/SKILL.md |
rdd-defect-workflow |
When RDD defects involve receipts, authority, recovery, delivery gates, or kill switches. | skills/rdd-defect-workflow/SKILL.md |
rdd-advisory-transport |
When changing reviewer transport, adapters, lens prompts/schemas, or transport capability policy. | skills/rdd-advisory-transport/SKILL.md |
issue-root-resolution |
When auditing backlog roots, proposing cluster fixes, or closing resolved/outdated issues. | skills/issue-root-resolution/SKILL.md |
systemic-issue-triage |
When triaging issues, bugs, backlogs, root causes, dead ends, or blocked users. | skills/systemic-issue-triage/SKILL.md |
gentle-ai-bench |
When touching bench/, journeys, driven mode, the journey corpus, or bench axes. |
skills/gentle-ai-bench/SKILL.md |