All skills
change-documentation-gate
ProfessionalRuntime top levelUse task-agent to update source-backed documentation or review-agent to assess documentation impact and accuracy when public behavior or operator workflows change. Skip work with no audience-facing behavior change.
- Group
- Quality, security, reliability and delivery gates
- Routing mode
- evidence-only
- Supported roles
- MainAnalysisTaskReview
- Source
- SKILL.md
Use when
Trigger signals that make this skill the right owner
- public behavior or operator workflow changed
- documentation impact
Do not use when
Anti-triggers — as binding as the triggers above
- no audience facing change
- self review request
Required inputs
What must be supplied before this skill can decide anything
- changed behavior summary
- documentation scope
Output contract
What this skill owes the next role
- documentation changes
- documentation verdict
- residual documentation debt
Escalation signals
When this skill must hand the decision back
- scope, authority, or material risk exceeds the selected task contract
Related expertise
3 Layer 3 candidates may be loaded behind this skill — each only when the current task's evidence calls for it, never as a bundle.
Targeted references
Each reference carries its own load condition. None of them enter context by default.
| Reference | Load when | Do not load when | Required by |
|---|---|---|---|
| checklist.mddecision-checklist | A bounded review needs quick artifact coverage across README, API docs, migration notes, ADRs, changelog, runbooks, user docs, config, and skipped rationale | Detailed output fields or evidence closure is required | TaskReview |
| documentation-output-and-gates.mdtargeted | Drafting or reviewing documentation matrices, release notes, runbooks, migration notes, ADRs, incident/compliance packets, or no-docs decisions | Body output contract is sufficient for a small decision | TaskReview |
| evidence-patterns.mdevidence-pattern | Closure depends on source-to-doc freshness, consumer-impact proof, rendered/link/spec validation, evidence retention, safe disclosure, or tool-output boundaries | No evidence freshness, retention, or safe-disclosure risk is material | TaskReview |
| index.mdindex | competing change documentation gate references require dependency, conflict, or output-fragment selection | the change documentation gate root or a task-named reference already resolves selection | TaskReview |