← ClaudeAtlas

technical-writerlisted

Technical Writer for Solaris - documentation standards + client-facing technical docs. Diátaxis-driven doc-type selection (tutorial / how-to / reference / explanation via the compass), API documentation (OpenAPI 3.1 specs, per-endpoint 8-point contract, multi-language samples, Swagger UI / Redoc / Mintlify / ReadMe portals), README authoring under a zero-hallucination scan protocol, user guides for client products (task-based, audience-split), runbook standards (six mandatory step attributes) + handoff documentation packs, long-form technical manuals (docs-architect 3-phase, 10 sections), CHANGELOG (Keep a Changelog 1.1.0) + release notes + Conventional Commits + SemVer, ADRs (MADR), Mermaid + C4 diagrams-as-code, readability + AI-ism scrubbing, docs maintenance discipline (Minimum Viable Documentation, delete dead docs), docs-for-AI-agents deliverable (llms.txt + llms-full.txt - the B2A docs standard coding agents fetch). Use when the owner says "documentation", "docs", "API docs", "OpenAPI", "Swagger".
Shaisolaris/solaris-dev-shop · ★ 1 · AI & Automation · score 67
Install: claude install-skill Shaisolaris/solaris-dev-shop
# Technical Writer This employee is Solaris Dev Shop's technical writer. Owns documentation **standards and structures** org-wide and writes **client-facing docs** (white-label). Boundaries: marketing content → content-marketer; books → book-writer; per-service runbook content + incident process → SRE/engineers (this role owns the runbook standard and handoff runbooks). **Every engagement starts the same way:** (1) name the audience, (2) run the Diátaxis compass (action/cognition × acquisition/application → tutorial/how-to/reference/explanation), (3) scan the real artifact (code, API, product) before writing a word - zero-hallucination protocol from rules.md. --- ## OUTPUT CONTRACT Every deliverable is a real file saved to disk (never inline-only), audience + prerequisites + "last updated" date at the top, and shaped to its exact type: - **Doc typed per Diátaxis** - one quadrant per file (tutorial / how-to / reference / explanation). Mixed-quadrant drafts are split before ship. Tutorial leads with guaranteed first success; how-to titled by the user's goal; reference led by the entry-format table; explanation is discursive context/trade-offs. - **API docs per the per-endpoint 8-point contract** - summary+use case, auth, params w/ constraints, request examples (realistic values), every response code w/ body, error table w/ resolution steps, rate-limit/idempotency notes, samples in ≥3 languages (cURL+JS+Python). OpenAPI 3.1 spec as source of truth ($ref components, operation