Home / netresearch / agent-rules-skill · skills/agent-rules/SKILL.md · GitHub

agent-rules skillA

agent-rules is agent-read markdown (skill) from netresearch/agent-rules-skill: Use when creating or updating AGENTS.md files, .github/copilot-instructions.md, or other AI agent rule files, onboarding AI agents to a project, standardizing agent documentation, or when anyone mentions AGENTS.md, agent rules, project onboarding, or codebase documentation for AI agents..

Indexed from public GitHub and served as immutable, content-addressed versions. Install it pinned to an exact SHA-256 with the mdr CLI, and every file is verified against the hash recorded here before it reaches your agent. The deterministic audit below grades the latest version, and the same file always earns the same grade.

What the file says

# AGENTS.md Generator Skill

Generate and maintain AGENTS.md files following the [agents.md convention](https://agents.md/). AGENTS.md is FOR AGENTS, not humans.

## When to Use

- Creating or updating AGENTS.md for new/existing projects
- **Scaffolding a new repository** — ship AGENTS.md with the initial commits; retrofitting later needs full re-verification
- Standardizing agent documentation across repositories
- Checking AGENTS.md freshness after code changes
- Onboarding AI agents to an unfamiliar codebase

## Scripts

Call every script by its full path: `bash ${CLAUDE_SKILL_DIR}/scripts/<name> PATH`. Calling one relative to the working directory is not covered by the frontmatter rule and raises a permission prompt per call.

| Script | Purpose |
|--------|---------|
| `generate-agents.sh PATH` | Generate AGENTS.md files |
| `validate-structure.sh PATH` | Validate structure compliance |
| `check-freshness.sh PATH` | Check if files are outdated |
| `verify-content.sh PATH` | Verify documented files/commands match codebase |
| `verify-commands.sh PATH` | Verify documented commands execute |
| `score-agents.sh PATH` | Grade AGENTS.md quality, worst-first |
…

Read the whole file at its exact version.

How to install

Latest version
mdr add netresearch/agent-rules-skill/agent-rules@v3.16.2
Exact content
mdr add netresearch/agent-rules-skill/agent-rules@sha256:de227d25e5cfcc80

Pin to a label to follow the author's releases, or to a sha256 to freeze the exact bytes forever. Either way the resolved hash is written to mdr.lock, and mdr install reproduces it on any machine.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_wyhjsnxwitmtw52l.svg)](https://markdownregistry.com/a/art_wyhjsnxwitmtw52l)

1 badge views in 30 days

Versions

versioncommittedcommitsizeaudit
v3.16.2 latest2026-09-18 7f3dbae 4,913 BA view · diff
v3.16.12026-09-11 a1c97e9 4,913 BA view · diff
v3.16.02026-09-03 5908d34 4,913 BA view · diff
v3.15.32026-08-29 5cb25c5 4,913 BA view · diff
v3.15.32026-08-29 21f0553 4,892 BA view

Audit of the latest version

A  17 of 17 checks passed. Deterministic, no model, same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (4913 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

netresearch/agent-rules-skill · 81 stars · license NOASSERTION · pushed 2026-09-24 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_wyhjsnxwitmtw52l
GET https://markdownregistry.com/api/v1/resolve?ref=netresearch/agent-rules-skill/agent-rules
GET https://markdownregistry.com/api/v1/blob/de227d25e5cfcc80aac0a01ebf9a78a0e106b15f15087cca87777f910a054401

Your agent does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

More from netresearch/agent-rules-skill

AGENTS.md@.github/workflows agents
netresearch/agent-rules-skill · .github/workflows/AGENTS.md
git:20260205.6b5aa9e · audit A · 81 stars
CLAUDE.md@.github/workflows claude
netresearch/agent-rules-skill · .github/workflows/CLAUDE.md
git:20260327.38f4b55 · audit B · 81 stars
AGENTS.md agents
netresearch/agent-rules-skill · AGENTS.md
git:20260401.cf879a7 · audit A · 81 stars
CLAUDE.md claude
netresearch/agent-rules-skill · CLAUDE.md
git:20260327.38f4b55 · audit B · 81 stars
AGENTS.md@skills/agent-rules agents
netresearch/agent-rules-skill · skills/agent-rules/AGENTS.md
git:20260225.a190152 · audit A · 81 stars
CLAUDE.md@skills/agent-rules claude
netresearch/agent-rules-skill · skills/agent-rules/CLAUDE.md
git:20260327.38f4b55 · audit B · 81 stars
AGENTS.md@skills/agent-rules/references/examples/coding-agent-cli agents
netresearch/agent-rules-skill · skills/agent-rules/references/examples/coding-agent-cli/AGENTS.md
git:20260225.a190152 · audit A · 81 stars
AGENTS.md@skills/agent-rules/references/examples/express-api-ts agents
netresearch/agent-rules-skill · skills/agent-rules/references/examples/express-api-ts/AGENTS.md
git:20260225.a190152 · audit A · 81 stars
AGENTS.md@skills/agent-rules/references/examples/express-api-ts/src agents
netresearch/agent-rules-skill · skills/agent-rules/references/examples/express-api-ts/src/AGENTS.md
git:20260225.a190152 · audit A · 81 stars
AGENTS.md@skills/agent-rules/references/examples/fastapi-app agents
netresearch/agent-rules-skill · skills/agent-rules/references/examples/fastapi-app/AGENTS.md
git:20260225.a190152 · audit A · 81 stars
AGENTS.md@skills/agent-rules/references/examples/fastapi-app/src agents
netresearch/agent-rules-skill · skills/agent-rules/references/examples/fastapi-app/src/AGENTS.md
git:20260225.a190152 · audit A · 81 stars
AGENTS.md@skills/agent-rules/references/examples/go-api-with-react-admin agents
netresearch/agent-rules-skill · skills/agent-rules/references/examples/go-api-with-react-admin/AGENTS.md
git:20260225.a190152 · audit A · 81 stars

Every file in netresearch/agent-rules-skill

Other files named agent-rules

agent-rules skill
mr-kelly/skills · skills/agent-rules/SKILL.md · Align all AI coding agents to a single source of truth. AGENTS.md for rules, .agents/skills/ for skills, symlinks for…
git:20260907.3d5d7e1 · audit A · 5 stars

Browse by kind, by grade A, or by owner.