tech-debtlisted
Install: claude install-skill y-miyazaki/config
**UTILITY SKILL** — technical debt survey and closed-set apply, not structural refactor.
## Input
- **Interactive:** natural-language request; run this skill's detect script unless detect JSON is already in context — parse per [category-input-schema.md](references/category-input-schema.md)
- **Automation:** detect JSON in prompt; read `may_edit`, `write_target`, and `report_file` from `## Constraints` per [category-automation-envelope.md](references/category-automation-envelope.md)
Path allowlist, when present, arrives in `## Constraints`.
## Output Specification
Tech-debt report per [common-output-format.md](references/common-output-format.md). Survey shape when `report_file` is not written; apply shape when written — within [category-scope.md](references/category-scope.md).
## Execution Scope
### USE FOR:
- Classify mechanical `signals[]` and `hotspots[]` into prioritized debt findings
- Survey: emit Candidates with Delegate hints (`refactor`, `docs-updater`, `self`, `human`)
- Apply: write `report_file`; apply closed-set fixes (`broken_doc_ref`, `stale_doc`, simple `pin_drift`) within allowlist
### DO NOT USE FOR:
- Structural refactors or architecture changes (use refactor)
- CI repair (use ci-sweeper)
- Security remediation beyond reporting
- Edit caller state files (owned by the caller after verification)
## Reference Files Guide
- [category-debt-taxonomy.md](references/category-debt-taxonomy.md) (always read)
- [common-checklist.md](references/common-checkl