← ClaudeAtlas

technical-writinglisted

Shape or edit substantial technical documents and human-facing project artifacts, including RFCs, design notes, investigation reports, decision records, briefs, results, reviews, and pull-request descriptions. Use collaborative composition when the author is still making material choices, and quiet editorial production when accepted facts are sufficient. Also use when explicitly invoked for ambiguous document work. Do not use for routine Pinboard coordination, minor copy edits, or generic coding work without a meaningful human-facing artifact.
valsteen/pinboard · ★ 4 · AI & Automation · score 77
Install: claude install-skill valsteen/pinboard
# Technical writing Help the author produce writing that a reader can understand, evaluate, and act on. Editorial polish must not change what the evidence supports. This skill owns document-specific composition and editing. When Pinboard selects it, the main Pinboard skill still owns the surrounding collaboration, accepted decisions, and workflow state. ## Choose the working mode Use **collaborative composition** when the document is substantial and audience, scope, emphasis, structure, or meaning is still being shaped with the author. Use **quiet editorial production** when the user asks for a finished artifact or the authoritative facts already determine truthful content. Pinboard briefs, results, reviews, reports, and pull-request descriptions normally use this mode during routine production. An explicit invocation selects this skill even when the artifact or intended depth would otherwise be ambiguous. If the user names a mode, follow it. Otherwise choose from the state of the work, not from the file extension. ## Establish the writing basis Identify the intended reader, the decision or action the document should support, and the sources that can substantiate it. Read the actual artifact and relevant sources before making material claims. Keep these states distinct whenever they matter: - observed; - inferred; - proposed; - accepted or agreed; - assumed; - disputed; - unresolved. Preserve exact identifiers, formulas, conditions, exceptions, ownership boundaries