clarify-docslisted
Install: claude install-skill serpro69/claude-toolbox
<!-- codex: tool-name mapping applied. See .codex/scripts/session-start.sh -->
# Clarify Documentation, PR Drafts and Issue Descriptions
Improve an existing document so its intended reader can understand the underlying
work. Produce a local edit; success depends on comprehension and fidelity, with no
document-length target.
## Inputs and boundaries
Accept local documentation, PR or issue-description drafts, remote PR/issue URLs
or pasted bodies, plus audience, purpose, requirements and source references.
GitHub and Linear are examples, not required integrations. Examples:
- `$kk:clarify-docs docs/configuration.md for service owners; use src/config/`
- `$kk:clarify-docs docs/feat/wip/import/design.md for the implementing developer`
- `$kk:clarify-docs pr-draft.md for repository reviewers; use the actual PR base/head`
- `$kk:clarify-docs <PR URL>; save the revised body to docs/feat/wip/import/pr-draft.md`
- `$kk:clarify-docs issue-draft.md; preserve the reported reproduction details`
- `$kk:clarify-docs <issue URL>; save to docs/feat/wip/import/issue-draft.md`
A directory permits discovery and selection, not a bulk rewrite. If selection is
consequentially ambiguous, ask which artifact to edit. Related requirements and
code may be read as evidence; only selected documentation may be changed.
Edit an explicitly selected local draft in place. A capture of pasted/remote input
is not automatically that draft. For remote or pasted input, use the caller's
destination or name a