technical-writinglisted
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