writing-for-agents
Skill11 starsChanged 3 months agoLicence not identifiedView on GitHub
Writing documents for agents. Use when creating or editing skills, or modifying AGENTS.md or CLAUDE.md.
234 other projects use a version of this, 74 of them edited; 20 of 74 edited versions we compared changed its rules; 24 new projects in the last 4 weeks, against 20 the 4 before.
How people change it
20 of 74 edited versions changed its rules, and some changes recur.
Of the 74 edited versions we compared: 54 keep every rule, 20 made changes of their own.
Rules people drop
- When the document you're writing is a skill, read [
SKILL-MECHANICS.md](SKILL-MECHANICS.md) for frontmatter, invocation choice, and router skills.dropped by 8 of 20 - Every step ends on a completion criterion, the condition that tells the agent the work is done. Two properties make it a lever:dropped by 4 of 20
- Every document and pointer you add spends one of two budgets:dropped by 2 of 20
Rules people add
- Keep a skill's
SKILL.mdunder 500 lines; past that, disclose.added by 2 of 20 - Before adding guidance to a skill, find its owner in the table; for a rule another skill owns, add a pointer to that skill plus the local consequence.added by 2 of 20
- When writing or rewriting, finish with the [meaning check](meaning-check.md) against the original or confirmed inputs. For read-only review, report suggestions without editing. [Source, license and local changes](SOURCE.md).added by 2 of 20
- A rule we can't quote: its licence doesn't allow itadded by 2 of 20
- A rule we can't quote: its licence doesn't allow itadded by 2 of 20
- A rule we can't quote: its licence doesn't allow itadded by 2 of 20
We split this file and each edited version into the rules they give an agent and match them by wording. A version that adds no rule of its own and has not changed since this file last did reads as an older text, so what it lacks is not counted as dropped. We keep no past texts of a file, so that is inferred, and an edited version that started from an older text still counts its gaps as drops.
Adopted by
Rising: 24 new projects took it in the last 4 weeks, 1.2× the 4 weeks before.
Most recently taken up by
- icetomoyo/CodingSkillstheir own version, first seen Nov 16, 2026
- Suge8/friedbuntheir own version, first seen Nov 15, 2026
- philoserf/claude-code-configword for word, first seen Nov 15, 2026
- niki914/zafiroword for word, first seen Nov 15, 2026
- Kealman/cland-v0edited, first seen Nov 15, 2026
- incredible404-rgb/zstackedited, first seen Nov 15, 2026
Used with
Projects with it also use writing-for-humans, setup-ts-deep-modules and 8 more.
Other files people use alongside this one.
Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
J03Fr0stSkillwriting-for-humans
Write and revise human-facing prose so it is clear, specific, natural, and faithful to the author's intent and genre. Use for emails, chat messages, articles, reports, documentation, announcements, talks, and other prose when the user asks to draft, diagnose, edit, rewrite, make writing less formulaic or less AI-like, sound more natural or direct, or match a supplied voice. Do not use for agent instructions such as skills or AGENTS.md, code-only work, verbatim transcription, or translation without editorial changes.
Also in 5 projects that use this
liufeng1976Skillsetup-ts-deep-modules
Wire dependency-cruiser into a TypeScript repo so each package is a deep module — implementation hidden in subfolders, reachable only through its entry-point files. User-invoked.
Also in 34 projects that use this
AWSSkillwizard
Generate an interactive bash wizard that walks a human through steps only they can perform. Use when provisioning infrastructure, setting up credentials or CI secrets, walking an unfamiliar third-party dashboard, or running a one-off migration or cutover. Don't invoke this for steps the agent can perform itself.
Also in 112 projects that use this
openchamberSkillclack-cli-patterns
Use when creating or modifying OpenChamber CLI commands, prompts, terminal output, non-TTY behavior, `--quiet`, or `--json` behavior.
Also in 3 projects that use this
MicrosoftSkillcloud-architecture-diagram
Create, edit, or review Azure and Microsoft ecosystem architecture, GitHub CI/CD, and auth/API diagrams as editable draw.io files; resolve Microsoft and GitHub icons. Use for architecture visualization, diagram critique, or missing icons. Azure DevOps only when explicitly requested. Not for competing-cloud architecture, deployment, live discovery, security certification, or unrelated charts.
Also in 3 projects that use this
openchamberSkilldrag-to-reorder
Use when implementing or modifying OpenChamber sortable or drag-to-reorder behavior, especially `@dnd-kit`, touch/mobile interactions, variable-width items, or wrapping layouts.
Also in 3 projects that use this
- +4 more from openchamber
Other versions234 projects use a version of this.
Word for word · 131
- mattpocock/skills★ 325k100% same
- QuivrHQ/quivr★ 40k100% same
- The-Vibe-Company/quivr★ 40k100% same
- formbricks/formbricks★ 13k100% same
- ArcReel/ArcReel★ 6.6k100% same
- withcoral/coral★ 4.9k100% same
- moeru-ai/xsai★ 667100% same
- aws/graph-explorer★ 492100% same
- niki914/zafiro★ 371100% same
- biersoeckli/QuickStack★ 365100% same
121 more not listed
Edited · 74
- openchamber/openchamber★ 13k50% same
- btriapitsyn/openchamber★ 13k54% same
- bestofjs/bestofjs★ 3.1k97% same
- CelestoAI/SmolVM★ 1.2k99% same
- deadlock-mod-manager/deadlock-mod-manager★ 58499% same
- hcloud-talos/terraform-hcloud-talos★ 36297% same
- Seekers2001/docs-governance★ 32098% same
- murray17/rovai-ai★ 26494% same
- qshanx/docs-governance★ 25398% same
- romiluz13/mifal★ 4797% same
64 more not listed
Wrote their own version · 29
- vinvcn/mattpocock-skills-zh-CN★ 5.8ksame name
- devcxl/mattpocock-skills-zh★ 543same name
- OyadotAI/oya-browser★ 349same name
- Integralist/agent-skills★ 29same name
- WenWuZhiDao/mattpocock-skills-zh★ 27same name
- Suge8/friedbun★ 13same name
- imMamdouhaboammar/matts-skills-into-chatgpt★ 8same name
- T-miracle/codex-skills-zh★ 5same name
- alunadev/ald-skills★ 4same name
- icetomoyo/CodingSkills★ 4same name
19 more not listed
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository8 other files it gives its agents.
- grillingSkill
- grill-meSkill
- grill-with-docsSkill
- handoffSkill
- researchSkill
- teachSkill
- to-questionnaireSkill
- wait-whatSkill
The file
We split this skill into the rules it gives an agent
3 rules. 2 are common, 0 are distinctive, and 1 is very specific to this project.
2
Common
Most of the 87 edited versions we read keep these.
0
Distinctive
This author's own choices. Worth a look.
1
Very specific
Tied to their project's names, files or tools. Probably skip.
The licence could not be identified — read it at the source. We count its rules but don't quote them. Read them on GitHub.
“Common” is measured: kept by at least 6 in 10 of the 87 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

