Technical Writing Clarity
aiming-lab/MetaClaw
A skill your agent uses when writing documentation, READMEs, technical specs, runbooks, or any text that explains a system or process to other engineers.
Design and run a documentation system for a team or product.
$ npx skills add rampstackco/claude-skills --skill documentation-strategy -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install rampstackco/claude-skills documentation-strategy --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/rampstackco/claude-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/documentation-strategy .claude/skills/documentation-strategy && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "documentation-strategy" agent skill from https://github.com/rampstackco/claude-skills/tree/main/skills/documentation-strategy into .claude/skills/documentation-strategy/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "documentation-strategy", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/rampstackco/claude-skills/tree/main/skills/documentation-strategyType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add rampstackco/claude-skills --skill documentation-strategy -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install rampstackco/claude-skills documentation-strategy --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/rampstackco/claude-skills.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/documentation-strategy .agents/skills/documentation-strategy && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "documentation-strategy" agent skill from https://github.com/rampstackco/claude-skills/tree/main/skills/documentation-strategy into .agents/skills/documentation-strategy/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "documentation-strategy", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add rampstackco/claude-skills --skill documentation-strategy -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install rampstackco/claude-skills documentation-strategy --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/rampstackco/claude-skills.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/documentation-strategy .cursor/skills/documentation-strategy && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "documentation-strategy" agent skill from https://github.com/rampstackco/claude-skills/tree/main/skills/documentation-strategy into .cursor/skills/documentation-strategy/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "documentation-strategy", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/rampstackco/claude-skills.git --path skills/documentation-strategy--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add rampstackco/claude-skills --skill documentation-strategy -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install rampstackco/claude-skills documentation-strategy --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/rampstackco/claude-skills.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/documentation-strategy .gemini/skills/documentation-strategy && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "documentation-strategy" agent skill from https://github.com/rampstackco/claude-skills/tree/main/skills/documentation-strategy into .gemini/skills/documentation-strategy/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "documentation-strategy", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install rampstackco/claude-skills documentation-strategyInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add rampstackco/claude-skills --skill documentation-strategy -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/rampstackco/claude-skills.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/documentation-strategy .github/skills/documentation-strategy && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "documentation-strategy" agent skill from https://github.com/rampstackco/claude-skills/tree/main/skills/documentation-strategy into .github/skills/documentation-strategy/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "documentation-strategy", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add rampstackco/claude-skills --skill documentation-strategy -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install rampstackco/claude-skills documentation-strategy --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/rampstackco/claude-skills.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/documentation-strategy .opencode/skills/documentation-strategy && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "documentation-strategy" agent skill from https://github.com/rampstackco/claude-skills/tree/main/skills/documentation-strategy into .opencode/skills/documentation-strategy/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "documentation-strategy", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
documentation-strategyDesign and run a documentation system for a team or product.
Documentation Strategy is an agent skill from rampstackco/claude-skills. Design and run a documentation system for a team or product. Use this skill when planning what to document, choosing a documentation tool, organizing existing docs, fixing stale documentation, designing a maintenance cadence, or scoping technical writing work. Triggers on documentation, docs, tech writing, knowledge base, wiki, runbook, README, internal docs, doc audit, doc maintenance, stale docs, where do we document. Also triggers when the team is repeatedly answering the same questions or when onboarding…
Its SKILL.md is about 3.3k tokens, which your agent loads only when the skill is triggered. The skill folder holds 3 other files, including reference files (for example `README.md` and `references/doc-types-guide.md`).
It sits in Writing & Content, covering Runbooks and postmortems, Technical writing and Knowledge bases. The repository describes itself as: Stack-agnostic Claude Skills covering the full website lifecycle: brand, design, content, SEO, dev, ops, growth, and research. Build, ship, audit, optimize. The licence is MIT.
10 steps, taken from the step headings in SKILL.md.
Read from SKILL.md and the folder at commit 482c9bf. It shows what the files ask for, not the result of running them.
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
No scripts in the folder and no shell commands in SKILL.md.
From the folder's file list and the shell code blocks in SKILL.md.
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Documentation Strategy loads about 3.3k tokens when it runs, and up to ~5.9k if it reads all its reference files. Until then it costs about 138 tokens; SKILL.md has 1,680 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
The full file from rampstackco/claude-skills at commit 482c9bf, republished under its MIT licence (© rampstackco). 1,680 words, ~3,265 tokens.
.claude/skills/documentation-strategy/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.Decide what gets documented, where, by whom, and how it stays fresh. Stack-agnostic. Applies to internal team docs, product docs, runbooks, READMEs, and knowledge bases.
team-onboarding-playbook)content-and-copy)content-strategy)code-review-web)content-and-copy)Different categories of doc serve different purposes. Conflating them is how docs get bad.
What things are. Looked up when needed.
Examples: API reference, configuration options, glossary, architecture diagrams, contact lists, decision log entries.
Properties:
How to do specific tasks. Procedural.
Examples: "Deploy to staging," "Reset a password," "Onboard a new contractor," "Run the backup restore drill."
Properties:
Why things are the way they are. Conceptual.
Examples: architecture rationale, design decision records (ADRs), strategy docs, vision documents.
Properties:
Learning-oriented. Walks someone from zero to capable.
Examples: "Getting started with our codebase," "Your first deploy," onboarding pathways.
Properties:
(This four-way split is the Diátaxis framework, well-known in tech writing. Memorize it.)
Different docs serve different audiences with different stakes.
Public docs, customer KBs, API references. High visibility, slow change.
Standards:
Docs used across teams: shared APIs, common services, company-wide processes.
Standards:
Docs for the team that owns them: how the team works, runbooks, decisions.
Standards:
Notes, drafts, work-in-progress. Not for others.
Standards:
Docs derived from code: API references generated from comments, schemas, etc.
Standards:
The tiering matters because the maintenance bar differs. Asking team-internal docs to meet customer-facing standards is wasteful and unsustainable.
The audit is often eye-opening. Most teams have more docs than they realize, in more places than they realize.
For each doc:
Some docs are mixed. Note the dominant category.
What documentation does the team need that doesn't exist?
Common gaps:
Ask people what they wish were documented. They know.
Docs that are:
Delete or archive. Stale docs are worse than missing docs (people might trust them).
Where docs live affects whether they're maintained.
Common locations:
Don't aim for one home. Aim for a clear answer to "where does this kind of doc live?"
Every doc has an owner. Without an owner, it goes stale.
Owner can be:
If an owner isn't obvious, the doc may not deserve to exist.
Per tier:
| Tier | Review cadence |
|---|---|
| Customer-facing | Per release, plus quarterly |
| Cross-team | Quarterly |
| Team-internal | Quarterly |
| Personal scratchpad | None |
| Auto-generated | On every change |
Maintenance includes:
Documentation isn't a separate project. It's part of the work that produces it.
The team that ships features without docs has less than they think they have.
Even great docs are useless if no one finds them.
What's measurable depends on the platform:
For internal docs, the qualitative measure is often more useful: are the same questions getting asked over and over? If yes, the docs aren't doing their job (either they don't exist, aren't found, or aren't clear).
Every code repo has a README that answers:
Five sentences each, often. Length isn't the goal. The READ-it-ME promise is.
Per significant decision:
# ADR-NNN: [Title]
Status: [Proposed / Accepted / Deprecated / Superseded]
Date: [Date]
## Context
[What's the situation? What forces are at play?]
## Decision
[What was decided?]
## Consequences
[What happens because of this decision? Both good and bad.]ADRs accumulate. They become the explanation layer for "why are we doing it this way."
Per system:
See incident-response and backup-and-disaster-recovery for runbook standards.
Per role:
See team-onboarding-playbook.
Lightweight version of ADRs. Date, decision, decider, why. Keeps a record without ceremony.
Terms that have specific meaning in the team or product. Reduces confusion. Trains AI tools too (more on that later).
The tool is less important than the discipline. That said:
| Tool category | Examples | Best for |
|---|---|---|
| Wiki | Notion, Confluence, GitBook | Cross-team, internal |
| Markdown in code | GitHub, GitLab, Bitbucket | READMEs, ADRs, technical |
| Docs sites | Docusaurus, Mintlify, ReadMe | Customer-facing, public docs |
| Internal sites | MkDocs, custom | Team-specific patterns |
Considerations:
For small teams: a single wiki tool is plenty. For larger: tiered tools.
LLMs and AI assistants increasingly read documentation. Some considerations:
llms.txt if relevantDocumentation as a "later" task. Always written later. Later means never. Make docs part of the work.
One mega-doc for everything. Wiki page that's 8,000 words. No one reads it. Break by category and topic.
Stale docs that nobody trusts. "Probably out of date" is the thought that kills documentation. Either keep current or archive.
Docs everyone agrees should exist but no one writes. The team agrees onboarding docs would be valuable. Months pass. No one writes them. Make ownership specific.
Wikis that are graveyards. Lots of pages, no one trusts any of them. Audit, archive, restart with a slimmer set.
Docs separated from code. API docs in a wiki, code in a repo. They drift. Co-locate.
Docs without examples. Reference without examples is hard to use. Examples make it concrete.
Examples that don't run. Code examples that worked once, drifted. Test examples in CI where possible.
Long-form when reference would do. A 2,000-word doc explaining what a 30-row table would. Use the right form.
Multiple sources of truth. Same info in three places, all slightly different. Pick canonical, redirect others.
Doc tools no one uses. Adopted because of a feature; team doesn't actually use it. Pick tools the team will use.
Doc style guide that's longer than the docs. Process beats product. Guide should be short.
No way to mark docs as deprecated. Old docs sit alongside current ones with no indication. Add a "deprecated" or "archived" status.
No analytics. No idea what's being used or what's missing. Even basic page views inform priorities.
Docs that read like specifications. Dense, formal, hard to scan. Write for the reader.
A documentation strategy document includes:
references/doc-types-guide.md: Detailed guide to the four doc types (reference, how-to, explanation, tutorial) with examples and templates for each.© rampstackco, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
SKILL.md and 2 other files (references) in skills/documentation-strategy of rampstackco/claude-skills.
Open the folder on GitHubat commit 482c9bf
Documentation Strategy next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Documentation Strategy this skillrampstackco/claude-skills | 940 | — | ~3.3k | Automated safety check: Pass | MIT | |
| Technical Writing Clarityaiming-lab/MetaClaw | 3.5k | — | ~244 | Automated safety check: Pass | MIT | |
| Persuasive Technical Writingmtarcure/claude-vibe-squad | 163 | — | ~1.8k | Automated safety check: Pass | MIT | |
| Technical Writercuriositech/some_claude_skills | 243 | — | ~1.4k | Automated safety check: Pass | MIT | |
| Obsidian WriterAtmosphere/atmosphere | 3.8k | — | ~2.6k | Automated safety check: Pass | Apache-2.0 | |
| Technical Writingrsmdt/the-startup | 551 | — | ~1.3k | Automated safety check: Pass | MIT |
aiming-lab/MetaClaw
A skill your agent uses when writing documentation, READMEs, technical specs, runbooks, or any text that explains a system or process to other engineers.
mtarcure/claude-vibe-squad
A skill your agent uses when drafting or revising long-form persuasive technical prose (an essay, post-mortem, launch narrative, or public technical release for X or the web) where the writing must…
curiositech/some_claude_skills
Expert technical documentation specialist for developer docs, API references, and runbooks.
Atmosphere/atmosphere
Write well-formatted notes to the atmosphere-vault Obsidian knowledge base.
rsmdt/the-startup
Create architectural decision records (ADRs), system documentation, API documentation, and operational runbooks.
gastownhall/beads
Sets the house style for the beads user docs: the canonical concept model, required terminology, prose and diagram conventions, and checks before docs work is done.
rampstackco/claude-skills
Run a structured after-action review (postmortem, retrospective) on a launch, incident, or completed project to capture timeline, root cause analysis, contributing factors, and actionable lessons.
rampstackco/claude-skills
Design measurement frameworks including event taxonomy, KPI hierarchy, dashboard architecture, attribution models, and analytics implementation strategy.
rampstackco/claude-skills
Build or audit a comprehensive brand style guide that documents the full brand system including story, logo system, color, typography, imagery, voice, applications, and dos/don'ts.
rampstackco/claude-skills
Develop or document a complete brand voice and tone system covering voice attributes, tone shifts by context, vocabulary preferences, grammar rules, and copy examples.
rampstackco/claude-skills
Write or edit website copy, blog content, and editorial pieces with attention to voice, structure, and goal.
rampstackco/claude-skills
Develop a content strategy covering editorial positioning, content pillars, formats, calendar, governance, and topical authority planning.
Design and run a documentation system for a team or product. Documentation Strategy is an agent skill from rampstackco/claude-skills. Design and run a documentation system for a team or product.
Documentation Strategy fits situations like: planning what to document; choosing a documentation tool; organizing existing docs; fixing stale documentation.
Run `npx skills add rampstackco/claude-skills --skill documentation-strategy -a claude-code`. Or copy the skill folder (skills/documentation-strategy in rampstackco/claude-skills) into .claude/skills/documentation-strategy in your project. Claude Code loads it when a task matches its description.
Run `npx skills add rampstackco/claude-skills --skill documentation-strategy -a codex`. Or copy the skill folder (skills/documentation-strategy in rampstackco/claude-skills) into .agents/skills/documentation-strategy in your project. Codex loads it when a task matches its description.
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add rampstackco/claude-skills --skill documentation-strategy -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/documentation-strategy, .gemini/skills/documentation-strategy, .github/skills/documentation-strategy and .opencode/skills/documentation-strategy in your project.
SKILL.md names no scripts, command-line tools or credentials: Documentation Strategy is instructions for the agent only.
SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
Documentation Strategy is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
About 3.3k tokens (SKILL.md is roughly 13k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 2.6k tokens, read only when the agent opens those files.
Skills that share tags, products or a category with Documentation Strategy: Technical Writing Clarity (aiming-lab/MetaClaw, 3.5k stars), Persuasive Technical Writing (mtarcure/claude-vibe-squad, 163 stars), Technical Writer (curiositech/some_claude_skills, 243 stars) and Obsidian Writer (Atmosphere/atmosphere, 3.8k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
rampstackco (a GitHub organization) maintains it in rampstackco/claude-skills, which has 940 GitHub stars. The repository holds 103 skills in this directory. The repository was last updated on October 7, 2026.
Source: rampstackco/claude-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.