Better Writing
Focuses on improving product copy in your project.
Install
npx skills add Dimon94/skills --skill better-writinggit clone --depth 1 https://github.com/Dimon94/skills.git /tmp/skills
mkdir -p ~/.claude/skills
cp -r /tmp/skills/skills/better-writing ~/.claude/skills/better-writingPersonal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.
From the SKILL.md
# Interface writing Clear and brief beats clever; consistent beats varied. The best error message is the interaction redesigned so the error cannot happen. How copy renders (capitalization via `text-transform`, truncation, smart punctuation) belongs to `better-typography`. Error markup and announcements (`aria-invalid`, live regions) belong to `better-accessibility`. Room for translated strings belongs to `better-layout`. ## Recon the existing voice Before writing or reviewing, read the copy nearby. Note the product's terminology, its localization conventions and any voice or content style guide. A deliberate brand voice is not a defect. Raise a departure from plain language only when it creates inconsistency, ambiguity, translation risk, or a tone the stakes don't support. ## One voice, flexible tone The product has one voice and its existing copy establishes it. A local edit does not get to invent a new one. Keep terms consistent: if it's "Archive" in the menu, it isn't "Move to storage" in the toast. Tone flexes with the stakes: | Context | Tone | | --- | --- | | Success, onboarding, empty states | Warm, can be light | | Routine actions, settings | Neutral, minimal | | Errors, destructive confirmations | Calm, plain, zero playfulness | | Data loss, security | Serious, explicit | ## Address the reader directly
Details
- Skill name
better-writing- Repository
- Dimon94/skills
- Path
skills/better-writing/SKILL.md- Repo updated
- 18 November 2026
FAQ
What does the Better Writing skill do?
Focuses on improving product copy in your project.
How do I install the Better Writing skill?
skills CLI (Claude Code, Cursor, Codex and more): npx skills add Dimon94/skills --skill better-writing. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.
Is Better Writing popular?
It lives in Dimon94/skills, which has 107 GitHub stars and 21 forks.
Related skills
Maintain Verification Skill
107Dimon94/skills
Periodic pass that keeps a project's verification skill and feature map honest: parallel source readers per feature, one live session driving every feature, at most one PR of proven corrections. Use for /maintain-verification-skill or "audit the verify skill".
Create Verification Skill
107Dimon94/skills
Generate a project-local verification skill that drives your app the way a user does — any language, framework, or platform. Use for /create-verification-skill, "make a control skill for this repo", or when a project has no scripted way to prove UI/CLI/service behavior.
How
107Dimon94/skills
Use for "how does X work", code walkthroughs before changing something, and placement / ownership / layering questions ("where should this live", "which package owns this", "is this the right layer"). Explains subsystem architecture, runtime flow, onboarding mental models. Use why for motivation.
Documentation
43aws-samples/sample-kiro-cli-multiagent-development
Technical documentation patterns including READMEs, API docs, runbooks, and architecture decision records. Use when writing documentation, creating runbooks, or documenting system architecture.
AWS Technical Docs
43aws-samples/sample-kiro-cli-multiagent-development
AWS technical documentation patterns covering procedures, lists, tables, titles, error messages, and content patterns. Use when writing AWS service documentation, procedures, troubleshooting guides, tutorials, or getting started content.
Harvest Debt
43aws-samples/sample-kiro-cli-multiagent-development
Collect SHORTCUT: markers across the codebase into a tech-debt ledger at docs/debt.md. Use when asked to harvest debt, audit technical shortcuts, or inventory deferred simplifications.
Browse the most popular Claude skills, all writing & content skills, or write your own with the skills generator.