Claude Skills · Writing & Editing
Docs Writing
mblode/agent-skillsWrites and audits technical documentation using the Diataxis framework and Stripe-style clarity. 48 rules across 9 categories covering voice, structure, clarity, code examples, formatting, navigation, scanability, content hygiene, and review. Use when writing docs, documenting APIs, writing documentation-site tutorials or how-to guides, auditing an existing README or docs site, or asking "review my docs", "improve this documentation", or "write docs for this". For editorial blog tutorials use the external ghostwriter skill with platform blog; for creating a README from scratch use readme-creat...
At a glance
This skill is for Writing & Editing.
git clone --depth 1 https://github.com/mblode/agent-skills
cp -r agent-skills/skills/docs-writing ~/.claude/skills/docs-writing
Setup, runtime and requirements describe mblode/agent-skills, the repo this skill ships in.
Also in mblode/agent-skills
View the repoGuides creation and improvement of best-practice agent skills following the open format specification. Covers frontmatter, progressive discl...
Sets up a repo so Claude Code, Codex, and Cursor all work in it, then audits, scores, and refactors the AGENTS.md and CLAUDE.md files agents...
Runs the npm release flow for an existing changesets package: create a changeset, fix lint/type/test/format failures, push, watch CI, merge...
Audits agentic applications for architecture and trust: tool parity, tool granularity, context injection, completion signals, approval gates...
Designs, deepens, and hardens TypeScript codebase architecture in three modes: folder structures, module contracts, and middleware pipelines...
Writes and edits short product and marketing copy, including landing pages, CTAs, onboarding strings, product descriptions, email subjects,...
Audits the smallest relevant developer-facing surface of a library, CLI, SDK, or npm package across API contracts, errors, CLI behavior, pub...
Provides architecture guidance for multi-tenant SaaS platforms on Cloudflare or Vercel. Covers platform choice, domain strategy, tenant iden...
Optimises SEO and technical foundations for Next.js App Router apps, covering sitemaps, robots, meta tags, structured data, canonical URLs,...
Builds and stress-tests implementation plans in two modes. Create mode scans code and docs, asks one question at a time with a recommended a...
Monitors an open PR, detects it from the current branch, polls for conflicts, CI failures, review comments, and merge readiness, fixes safe...
Creates GitHub pull requests with short, human-sounding descriptions. Adds a Linear issue ID prefix when available, keeps titles under 60 ch...
Other Writing & Editing skills
Guide users through a structured workflow for co-authoring documentation. Use when user wants to write documentation, proposals, technical s...
Edit and improve articles by restructuring sections, improving clarity, and tightening prose. Use when user wants to edit, revise, or improv...
Writing, exploit — shape raw material into an article, paragraph by paragraph.
Reference for writing and editing skills well — the vocabulary and principles that make a skill predictable.
Writing, exploit — assemble raw material into a journey of beats, grounding each term before a beat leans on it.
Writing, explore — mine raw fragments, no structure yet.