Writing Design Docs
by riekelt85e53729dd95No license28 starsListed Oct 8, 2026Updated Oct 8, 2026Repository updated 3 weeks ago
Use when writing a proposal, RFC, design document, spec, or migration plan - anything that argues for a change, records a design, or asks readers for input on one. Encodes the proposal skeleton, the Why & What decision box, and the completeness checks. Use whenever a change needs arguing or scoping in writing, even if the user just says "write up the approach".
Add to a SourceWeft workspace
- Open the skill in your dashboard and add it to a workspace.
- Enable it for the chats that should use it.
This skill is instructions only: it ships no scripts to execute.
Add to SourceWeftYou will be asked to sign in first, then taken straight to this skill.
Ask your agent to install it
Paste this prompt into Claude Code, Codex, Cursor or another agent that can run commands — or into SourceWeft chat. The agent reads this skill's install guide, shows you its source, license and scripts, and installs it with the SourceWeft CLI once you agree.
Read https://sourceweft.com/skills/gh-riekelt-technical-writer-writing-design-docs/install.md and install the skill it describes. Before installing, show me its source, license and whether it ships scripts, and wait for my OK. Ask me before changing anything else on my machine.Install it yourself from a terminal
For Claude Code, Codex, Cursor and other local agents. The SourceWeft CLI fetches the skill from its source repository at the commit scanned here, and verifies every file against the hashes recorded when the skill was scanned. If anything differs, nothing is written.
npx @sourceweft/cli skills install gh-riekelt-technical-writer-writing-design-docsAdd --agent claude-code, codex, cursor or universal to choose which agent gets it (Claude Code by default).
Upstream installer — not verified by SourceWeft
The open-source skills installer fetches the same pinned commit, but does not check the files against the hashes SourceWeft recorded.
npx skills add https://github.com/riekelt/technical-writer/tree/85e53729dd959a2795d593d6769068e342cf3486/plugins/technical-writer/skills/writing-design-docsSource and attribution
Source:riekelt/technical-writerinplugins/technical-writer/skills/writing-design-docsat commit85e5372
License: No license
Content belongs to its original authors. SourceWeft indexes it from a public repository.
More from riekelt/technical-writer
Writing Runbooks
riekelt
Guides writing of runbooks, setup, release, migration and deprecation procedures that someone will execute under time pressure.
Writing Postmortems
riekelt
Guides writing blameless postmortems, incident reports, and root-cause analyses with evidence-based timelines and owned action items.
Writing Issues
riekelt
Guides writing tracker issues such as epics, stories, tasks, bugs and spikes with testable acceptance criteria.
Writing Changelogs
riekelt
Guides writing changelog entries, release notes and handover summaries with fixed entry shapes and honesty conventions.
Technical Writing
riekelt
House style and truth rules for drafting, restructuring, and revising technical documents such as specs, design docs, and READMEs.
Reviewing Technical Prose
riekelt
Reviews and rewrites technical prose, producing severity-mapped findings reports and a pre-delivery checklist.
More in Writing & Content
Doc Coauthoring
anthropics
Guides users through a three-stage workflow to co-author documentation, proposals, specs and decision docs.
Writing Guidelines
vercel-labs
Reviews documentation and prose against fetched Writing Guidelines and reports style findings.
Job Post Builder
anthropics
Builds a hiring packet — job post, interview guide with rubrics, and offer letter template — from a role brief.
Write Spec
anthropics
Turns a feature idea or problem statement into a structured PRD with goals, user stories, requirements and metrics.
Draft Content
anthropics
Drafts marketing content such as blog posts, social posts, newsletters, landing pages, press releases and case studies.
Brand Voice Enforcement
anthropics
Applies existing brand voice guidelines to sales and marketing content, then explains the brand choices made.