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

5 rules. About 0 are common, 3 are distinctive, and 2 are very specific to this project.

• ≈0

  Common · estimate

  Many files like this have a rule of this kind.

• ≈3

  Distinctive · estimate

  This author's own choices. Worth a look.

• 2

  Very specific

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

• Common
• Distinctive
• Very specific

1. Very specific:

   Every Skill must have SKILL.md and agents/openai.yaml.

   line 6
2. Distinctive:

   Every packaged Skill is model-invoked in this curated edition so the router can reach it automatically.

   line 7
3. Distinctive:

   Keep upstream provenance and MIT attribution accurate.

   line 9
4. Distinctive:

   Do not exclude a Skill solely because upstream called it misc or beta.

   line 10
5. Very specific:

   Run python3 scripts/validate_plugin.py and deterministic double packaging before committing a release.

   line 11

≈ “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 repository42 other files it gives its agents.

  • ai-data-remediationSkill
  • ai-engineeringSkill
  • codebase-designSkill
  • code-reviewSkill
  • diagnosing-bugsSkill
  • domain-modelingSkill
  • engineering-workflow-guideSkill
  • git-safety-guardrailsSkill
  • goalSkill
  • grillingSkill
  • grill-meSkill
  • grill-with-docsSkill
  • handoffSkill
  • implementSkill
  • implement-specSkill
  • improve-codebase-architectureSkill
  • j-spaceSkill
  • migrate-to-shoehornSkill
  • ml-best-practicesSkill
  • prototypeSkill
  • researchSkill
  • resolving-merge-conflictsSkill
  • retroSkill
  • scaffold-exercisesSkill
  • setup-engineering-workflowsSkill
  • setup-pre-commitSkill
  • setup-ts-deep-modulesSkill
  • skill-conductorSkill
  • tddSkill
  • teachSkill
  • to-questionnaireSkill
  • to-specSkill
  • to-ticketsSkill
  • triageSkill
  • wait-whatSkill
  • wayfinderSkill
  • wizardSkill
  • workflow-designerSkill
  • writing-beatsSkill
  • writing-for-agentsSkill
  • writing-fragmentsSkill
  • writing-shapeSkill