← ClaudeAtlas

clarify-docslisted

TRIGGER when: asked to clarify or improve existing documentation, PR drafts or issue descriptions, including URLs and pasted bodies. Saves results locally, grounded in requirements and source while preserving meaning. Not for requests to implement, fix or work on an issue, code, config, generic response brevity, or agent instructions. Explicit instruction or SKILL.md targets receive a $kk:implement suggestion without edits or invoking implementation.
serpro69/claude-toolbox · ★ 155 · Data & Documents · score 84
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