We split this AGENTS.md into the rules it gives an agent

9 rules. About 0 are common, 4 are distinctive, and 5 are very specific to this project.

• ≈0

  Common · estimate

  Many files like this have a rule of this kind.

• ≈4

  Distinctive · estimate

  This author's own choices. Worth a look.

• 5

  Very specific

  Tied to their project's names, files or tools. Probably skip.

• Common
• Distinctive
• Very specific

1. Very specific:

   Use writing-skills before creating or editing any skill in skills/.

   line 7
2. Very specific:

   Keep each skill directory flat and include SKILL.md, assets/, references/, and scripts/.

   line 9
3. Very specific:

   Prefer shared repository references in references/ and shared templates in assets/.

   line 10
4. Distinctive:

   Do not embed machine-specific absolute paths in published docs or skills unless the file is an explicit local validation target.

   line 11
5. Distinctive:

   Treat the current public skill catalog as provisional until the sibling eval repo proves which candidate skills create real uplift.

   line 12
6. Distinctive:

   Keep the first builder path focused on standard Gear/Vara Sails, not Vara.eth-first workflows.

   line 13
7. Very specific:

   Run make verify before claiming the repo is ready.

   line 16
8. Very specific:

   Keep installation working through scripts/install-codex-skills.sh.

   line 17
9. Distinctive:

   Keep repository docs aligned with the product split: this repo owns skills and packaging.

   line 18

≈ “Common” is an estimate: at least 1 in 5 of the 36,368 AGENTS.md files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

• Where files are headingNew AGENTS.md files have more rules about keeping secrets out of the code, and fewer about code style.

  Of the AGENTS.md files we read, the 28,693 first seen in the last six months, against the older ones: the kind of rule that gained most share, and the kind that lost most. About files like this in general, not this one, and an estimate, since a kind is a pattern in the words.

• In this repository27 other files it gives its agents.

  • CLAUDE.mdCLAUDE.md
  • vara-skillsSkill
  • vara-skillsSkill
  • awesome-sails-vftSkill
  • gear-architecture-plannerSkill
  • gear-builtin-actorsSkill
  • gear-gstd-api-mapSkill
  • gear-message-executionSkill
  • gtest-tdd-loopSkill
  • idea-to-specSkill
  • sails-architectureSkill
  • sails-dev-envSkill
  • sails-ethexe-architectureSkill
  • sails-ethexe-implementerSkill
  • sails-feature-workflowSkill
  • sails-frontendSkill
  • sails-gtestSkill
  • sails-idl-clientSkill
  • sails-indexerSkill
  • sails-local-smokeSkill
  • sails-new-appSkill
  • sails-program-evolutionSkill
  • sails-rust-implementerSkill
  • ship-sails-appSkill
  • task-decomposerSkill
  • vara-skills-upgradeSkill
  • vara-walletSkill