Technical Writing Rules
RulesFreeRules for agent-written docs, commits, and PR descriptions: lead with the answer, cut hedging, and never invent certainty
v1.0.0MIT
npx openagents-cli add openagents/writing-style-rules --runtime claude-codeTechnical Writing Rules
Agent prose has recognizable tells: an opening that restates the question, three hedges per paragraph, a bulleted list where a sentence would do, and a closing offer nobody asked for. These rules cut all of it, and add the one that matters most, which is never sounding more certain than you are.
When to use
- Documentation, READMEs, commit messages, PR descriptions, and code comments.
- Status updates and summaries an agent writes for a human to read.
- Anywhere an agent's output will be read by someone who was not watching it work.
Install
bash
npx openagents-cli add openagents/writing-style-rules| Runtime | Installed to |
|---|---|
claude-code | .claude/skills/writing-style-rules/ |
cursor | .cursor/rules/writing-style-rules/ |
codex | .codex/skills/writing-style-rules/ |
openai-agents | agents/writing-style-rules/ |
generic | .openagents/writing-style-rules/ |
What is in the package
RULES.md- the rules, with a before and after for each.patterns.md- the specific phrases to cut, and what to write instead.
License
MIT