Not in the top 1,000 by GitHub stars
anildash/better-documents
A SKILL.md for Claude that applies communication best practices to AI-generated and AI-reviewed business documents
History
Review weekly changes to SKILL.md before updating. Dates mark the weeks in which we observed each version; checks apply to the recorded commits.
View weekly changes
SKILL.md
Week of Nov 2, 2026 · Line counts unavailable
Before Not checked yet → After Instructions only
First observation → 31f27d71eb6f
No earlier version was observed for comparison.
180GitHub stars
1star in 7 days
1skill in this repository
1commit in 30 days
Heat
2.6- Star growth, last 7 daysNot available
- Star growth, last 24 hoursNot available
- Rank movement, last 7 daysNot available
- Commits, last 30 daysNot available
- Accounts asking about it through MCP, last 7 daysNot available
- Hot votes this weekNot available
Heat never changes the order by stars, and sponsorship never touches it. How heat works
Stars over time
30-day change not yet available: not enough history.
Individual skills in this repository
How it works
better-documents
When your agent uses it
Apply communication best practices when generating or reviewing any document, presentation, report, memo, slide deck, proposal, or email. Use this skill when asked to write, create, draft, or generate a document or presentation — apply the principles at generation time, not as an afterthought. Also use when asked to "review my doc," "look at this deck," "does this make sense," "is this clear," "improve this proposal," "check this before I send it," "make this more effective," or any request to evaluate whether a document will land with its audience. Use this skill even when the request seems minor — a "quick look" or a "short memo" is exactly when these principles matter most.
What it loads into context
Frontmatter
180 tokensAlways available to the agent
SKILL.md
3,467 tokensWhen the skill is activated
Reference documents
6,988 tokensLoaded on request
Token counts are estimates. Scripts run separately; they are not counted as reference context.
The playbook
- Scope
- Modes
- The Five Passes
- Reader Test
- Expert Panel
- AI Tells in Prose
- Output Format
- Constraints
Files
BLOG-NOTES.mddoc4,559 bytesLICENSEasset35,149 bytesREADME.mddoc3,458 bytesSKILL.mdcore15,455 bytesdocument-design.mddoc6,618 bytesexamples/board-update-ab.mddoc7,823 bytesreferences/ai-tells.mddoc1,714 bytesreferences/boardroom.mddoc3,442 bytesreferences/formatting-restraint.mddoc1,951 bytesreferences/visual-style.mddoc1,370 bytes
No excerpt is shown for this license. Read the source on GitHub.
View the complete source on GitHubSkills included
- better-documents
Repository facts
- License
- GPL-3.0
- Created
- May 28, 2026
- Last pushed
- Oct 16, 2026
- Forks
- 1
- Open issues
- 1
- Project activity
- Active
Before you install
Instructions onlyAutomated signals, not a guarantee
Checked Nov 6, 2026
- No broad tool permissions
- No dangerous shell commands
- 14 network referencesin 5 files: LICENSE:4 SKILL.md:22 document-design.md:3 and 2 more
- No hidden or obfuscated text
- No instruction overrides
- No executable scripts
- No access to secrets
- No requests to vote in Hot
Show all 14 signals by file
LICENSE
- Network accessline 4
Copyright (C) 2007 Free Software Foundation, Inc. <https://fsf.org/> - Network accessline 647
You should have received a copy of the GNU General Public License along with this program. If not, see <https://www.gnu.org/licenses/>. - Network accessline 648
along with this program. If not, see <https://www.gnu.org/licenses/>. - Network accessline 665
if any, to sign a "copyright disclaimer" for the program, if necessary. For more information on this, and how to apply and follow the GNU GPL, see <https://www.gnu.org/licenses/>. - Network accessline 667
<https://www.gnu.org/licenses/>. - Network accessline 672
the library. If this is what you want to do, use the GNU Lesser General Public License instead of this License. But first, please read <https://www.gnu.org/licenses/why-not-lgpl.html>. - Network accessline 674
<https://www.gnu.org/licenses/why-not-lgpl.html>.
README.md
- Network accessline 59
This tool is based on my blog post [Make better documents](https://www.anildash.com/2024/03/10/make-better-documents/), from March 2024, which many people said they found useful. Now these suggestions have been translated from advice for hu
SKILL.md
document-design.md
- Network accessline 3
*Distilled from [Make better documents.](https://www.anildash.com/2024/03/10/make-better-documents/) by Anil Dash. Original post © Anil Dash.* - Network accessline 133
*Source: [anildash.com/2024/03/10/make-better-documents](https://www.anildash.com/2024/03/10/make-better-documents/) — last accessed May 2026.*
references/boardroom.md
- Network accessline 4
more than "who are they" — it needs how they actually read, decide, and exercise power. This reference is based on [What does a board of directors do?](https://www.anildash.com/2024/06/20/dash-board/) by Anil Dash. - Network accessline 6
directors do?](https://www.anildash.com/2024/06/20/dash-board/) by Anil Dash.
How the signals fit together
Facts from a static read of the files at the pinned commit. They describe what the code does, not why.
Some files could not be read; the facts below still hold.
Signal confidence: 7 facts
- Network access in prose of documentationREADME.md:59Low confidence
- Network access in prose of the SKILL.mdSKILL.md:22Low confidence
- Network access in prose of the SKILL.mdSKILL.md:347Low confidence
- Network access in prose of documentationdocument-design.md:3Low confidence
- Network access in prose of documentationdocument-design.md:133Low confidence
- Network access in prose of documentationreferences/boardroom.md:4Low confidence
- Network access in prose of documentationreferences/boardroom.md:6Low confidence
Works with
| Agent | Status | Evidence | Install to |
|---|---|---|---|
| Claude Code | Compatible | Standard SKILL.md SKILL.md | .claude/skills/<skill-name>/ |
| Codex | Compatible | Standard SKILL.md SKILL.md | .agents/skills/<skill-name>/ |
| Cursor | Compatible | Standard SKILL.md SKILL.md | .cursor/skills/<skill-name>/ |
| Gemini CLI | Compatible | Standard SKILL.md SKILL.md | .gemini/skills/<skill-name>/ |
| GitHub Copilot | Compatible | Standard SKILL.md SKILL.md | .github/skills/<skill-name>/ |
| OpenCode | Compatible | Standard SKILL.md SKILL.md | .opencode/skills/<skill-name>/ |
- Native The repository ships a manifest, folder or frontmatter field for this agent.
- Compatible A standard SKILL.md that this agent can read.
- Unknown No evidence either way.
Derived automatically from paths, manifests and frontmatter. Not tested on each agent.
