{"id":"13599085-648b-4c7e-93e3-a83d04e27002","shortId":"UTz9aw","kind":"skill","title":"agent-rules","tagline":"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","description":"# AGENTS.md Generator Skill\n\nGenerate and maintain AGENTS.md files following the [agents.md convention](https://agents.md/). AGENTS.md is FOR AGENTS, not humans.\n\n## When to Use\n\n- Creating or updating AGENTS.md for new/existing projects\n- Standardizing agent documentation across repositories\n- Checking if AGENTS.md files are current with recent code changes\n- Onboarding AI agents to an unfamiliar codebase\n\n## Scripts\n\n| Script | Purpose |\n|--------|---------|\n| `scripts/generate-agents.sh PATH` | Generate AGENTS.md files |\n| `scripts/validate-structure.sh PATH` | Validate structure compliance |\n| `scripts/check-freshness.sh PATH` | Check if files are outdated |\n| `scripts/verify-content.sh PATH` | Verify documented files/commands match codebase |\n| `scripts/verify-commands.sh PATH` | Verify documented commands execute |\n| `scripts/detect-project.sh PATH` | Detect language, version, build tools |\n| `scripts/detect-scopes.sh PATH` | Identify directories needing scoped files |\n| `scripts/extract-commands.sh PATH` | Extract commands from build configs |\n| `scripts/extract-ci-rules.sh PATH` | Extract CI quality gates and version matrix |\n| `scripts/extract-architecture-rules.sh PATH` | Extract module boundaries |\n| `scripts/extract-adrs.sh PATH` | Extract architectural decision records |\n| `scripts/extract-github-rulesets.sh PATH` | Extract GitHub rulesets and merge rules |\n\nSee `references/scripts-guide.md` for full options.\n\n## Workflow\n\n1. **Detect**: `detect-project.sh` + `detect-scopes.sh` to identify stacks and subsystems\n2. **Extract**: `extract-commands.sh`, `extract-ci-rules.sh`, etc. to gather facts\n3. **Generate**: `generate-agents.sh` with `--style=thin` (default) or `--verbose`\n4. **Verify**: `verify-content.sh` + `verify-commands.sh` -- MANDATORY before done\n\nUse `--update` to preserve human-curated content outside `<!-- GENERATED -->` markers.\n\n## Core Principles\n\n- **Structured over Prose** -- tables parse faster than paragraphs\n- **Never Fabricate** -- only document what exists; verify every command and path\n- **Pointer Principle** -- point to files, don't duplicate content\n- **Auto Symlinks** -- CLAUDE.md/GEMINI.md symlinks by default (see [`ai-tool-compatibility.md`](references/ai-tool-compatibility.md))\n\n## References\n\n| File | Contents |\n|------|----------|\n| [`verification-guide.md`](references/verification-guide.md) | Verification steps, design principles |\n| [`scripts-guide.md`](references/scripts-guide.md) | Script options, validation checklist |\n| [`ai-tool-compatibility.md`](references/ai-tool-compatibility.md) | 16-agent compatibility matrix |\n| [`output-structure.md`](references/output-structure.md) | Root/scoped sections |\n| [`git-hooks-setup.md`](references/git-hooks-setup.md) | Hook framework detection and setup |\n| [`examples/`](references/examples/) | Complete examples |\n\n## Templates\n\nRoot: `assets/root-thin.md` (default), `root-verbose.md`. Scoped: `assets/scoped/` -- `backend-go.md`, `backend-php.md`, `python-modern.md`, `typo3.md`, `symfony.md`, `skill-repo.md`, `cli.md`, `frontend-typescript.md`, `oro.md`.\n\n## Supported Projects\n\nGo, PHP (Composer/Laravel/Symfony/TYPO3/Oro), TypeScript (React/Next/Vue/Node), Python (pip/poetry/ruff/mypy), Skill repos, Hybrid (multi-stack with auto-scoping).\n\n## See Also\n\n- [`agent-harness-skill`](https://github.com/netresearch/agent-harness-skill) — broader agent-readiness harness (CI verification, enforcement). Invokes this skill when AGENTS.md is missing.\n- [`skill-repo-skill`](https://github.com/netresearch/skill-repo-skill) — skill-repo structure (plugin.json, split licensing, release workflows).","tags":["agent","rules","skill","netresearch","agent-skills","agents-md","ai-agent","ai-agents","claude-code-skill","convention","documentation","open-standard"],"capabilities":["skill","source-netresearch","skill-agent-rules","topic-agent-skills","topic-agents-md","topic-ai-agent","topic-ai-agents","topic-claude-code-skill","topic-convention","topic-documentation","topic-open-standard","topic-skill"],"categories":["agent-rules-skill"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/netresearch/agent-rules-skill/agent-rules","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add netresearch/agent-rules-skill","source_repo":"https://github.com/netresearch/agent-rules-skill","install_from":"skills.sh"}},"qualityScore":"0.467","qualityRationale":"deterministic score 0.47 from registry signals: · indexed on github topic:agent-skills · 35 github stars · SKILL.md body (3,634 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-05-01T12:57:16.400Z","embedding":null,"createdAt":"2026-04-18T22:22:27.943Z","updatedAt":"2026-05-01T12:57:16.400Z","lastSeenAt":"2026-05-01T12:57:16.400Z","tsv":"'/).':55 '/gemini.md':259 '/netresearch/agent-harness-skill)':345 '/netresearch/skill-repo-skill)':367 '1':182 '16':283 '2':191 '3':199 '4':208 'across':75 'agent':2,15,20,25,32,59,73,89,284,340,348 'agent-harness-skil':339 'agent-readi':347 'agent-rul':1 'agents.md':9,31,41,47,51,54,56,68,79,100,358 'agents.md/).':53 'ai':14,19,40,88 'ai-tool-compatibility.md':264,281 'also':338 'anyon':29 'architectur':165 'assets/root-thin.md':304 'assets/scoped':308 'auto':255,335 'auto-scop':334 'backend-go.md':309 'backend-php.md':310 'boundari':161 'broader':346 'build':132,146 'chang':86 'check':77,109 'checklist':280 'ci':151,351 'claude.md':258 'claude.md/gemini.md':257 'cli.md':315 'code':85 'codebas':37,93,120 'command':125,144,243 'compat':285 'complet':300 'complianc':106 'composer/laravel/symfony/typo3/oro':322 'config':147 'content':222,254,268 'convent':52 'core':225 'creat':6,65 'curat':221 'current':82 'decis':166 'default':205,262,305 'design':273 'detect':129,183,295 'detect-project.sh':184 'detect-scopes.sh':185 'directori':137 'document':26,38,74,117,124,238 'done':214 'duplic':253 'enforc':353 'etc':195 'everi':242 'exampl':298,301 'execut':126 'exist':240 'extract':143,150,159,164,170,192 'extract-ci-rules.sh':194 'extract-commands.sh':193 'fabric':236 'fact':198 'faster':232 'file':10,17,48,80,101,111,140,250,267 'files/commands':118 'follow':49 'framework':294 'frontend-typescript.md':316 'full':179 'gate':153 'gather':197 'generat':42,44,99,200 'generate-agents.sh':201 'git-hooks-setup.md':291 'github':171 'github.com':344,366 'github.com/netresearch/agent-harness-skill)':343 'github.com/netresearch/skill-repo-skill)':365 'github/copilot-instructions.md':11 'go':320 'har':341,350 'hook':293 'human':61,220 'human-cur':219 'hybrid':329 'identifi':136,187 'invok':354 'languag':130 'licens':374 'maintain':46 'mandatori':212 'marker':224 'match':119 'matrix':156,286 'mention':30 'merg':174 'miss':360 'modul':160 'multi':331 'multi-stack':330 'need':138 'never':235 'new/existing':70 'onboard':18,35,87 'option':180,278 'oro.md':317 'outdat':113 'output-structure.md':287 'outsid':223 'paragraph':234 'pars':231 'path':98,103,108,115,122,128,135,142,149,158,163,169,245 'php':321 'pip/poetry/ruff/mypy':326 'plugin.json':372 'point':248 'pointer':246 'preserv':218 'principl':226,247,274 'project':23,34,71,319 'prose':229 'purpos':96 'python':325 'python-modern.md':311 'qualiti':152 'react/next/vue/node':324 'readi':349 'recent':84 'record':167 'refer':266 'references/ai-tool-compatibility.md':265,282 'references/examples':299 'references/git-hooks-setup.md':292 'references/output-structure.md':288 'references/scripts-guide.md':177,276 'references/verification-guide.md':270 'releas':375 'repo':328,363,370 'repositori':76 'root':303 'root-verbose.md':306 'root/scoped':289 'rule':3,16,33,175 'ruleset':172 'scope':139,307,336 'script':94,95,277 'scripts-guide.md':275 'scripts/check-freshness.sh':107 'scripts/detect-project.sh':127 'scripts/detect-scopes.sh':134 'scripts/extract-adrs.sh':162 'scripts/extract-architecture-rules.sh':157 'scripts/extract-ci-rules.sh':148 'scripts/extract-commands.sh':141 'scripts/extract-github-rulesets.sh':168 'scripts/generate-agents.sh':97 'scripts/validate-structure.sh':102 'scripts/verify-commands.sh':121 'scripts/verify-content.sh':114 'section':290 'see':176,263,337 'setup':297 'skill':43,327,342,356,362,364,369 'skill-agent-rules' 'skill-repo':368 'skill-repo-skil':361 'skill-repo.md':314 'source-netresearch' 'split':373 'stack':188,332 'standard':24,72 'step':272 'structur':105,227,371 'style':203 'subsystem':190 'support':318 'symfony.md':313 'symlink':256,260 'tabl':230 'templat':302 'thin':204 'tool':133 'topic-agent-skills' 'topic-agents-md' 'topic-ai-agent' 'topic-ai-agents' 'topic-claude-code-skill' 'topic-convention' 'topic-documentation' 'topic-open-standard' 'topic-skill' 'typescript':323 'typo3.md':312 'unfamiliar':92 'updat':8,67,216 'use':4,64,215 'valid':104,279 'verbos':207 'verif':271,352 'verifi':116,123,209,241 'verification-guide.md':269 'verify-commands.sh':211 'verify-content.sh':210 'version':131,155 'workflow':181,376","prices":[{"id":"dd8ce1e3-cc2c-4f36-9940-84a5780283b3","listingId":"13599085-648b-4c7e-93e3-a83d04e27002","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"netresearch","category":"agent-rules-skill","install_from":"skills.sh"},"createdAt":"2026-04-18T22:22:27.943Z"}],"sources":[{"listingId":"13599085-648b-4c7e-93e3-a83d04e27002","source":"github","sourceId":"netresearch/agent-rules-skill/agent-rules","sourceUrl":"https://github.com/netresearch/agent-rules-skill/tree/main/skills/agent-rules","isPrimary":false,"firstSeenAt":"2026-04-18T22:22:27.943Z","lastSeenAt":"2026-05-01T12:57:16.400Z"}],"details":{"listingId":"13599085-648b-4c7e-93e3-a83d04e27002","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"netresearch","slug":"agent-rules","github":{"repo":"netresearch/agent-rules-skill","stars":35,"topics":["agent-skills","agents-md","ai-agent","ai-agents","claude-code-skill","convention","documentation","open-standard","skill"],"license":"other","html_url":"https://github.com/netresearch/agent-rules-skill","pushed_at":"2026-04-30T09:07:10Z","description":"Agent Skill for generating AGENTS.md files following the agents.md convention | Claude Code compatible","skill_md_sha":"ad1ba1c153f8f2334c80000134589892e7bdd58c","skill_md_path":"skills/agent-rules/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/netresearch/agent-rules-skill/tree/main/skills/agent-rules"},"layout":"multi","source":"github","category":"agent-rules-skill","frontmatter":{"name":"agent-rules","license":"(MIT AND CC-BY-SA-4.0). See LICENSE-MIT and LICENSE-CC-BY-SA-4.0","description":"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.","compatibility":"Requires bash 4.3+, jq 1.5+, git 2.0+."},"skills_sh_url":"https://skills.sh/netresearch/agent-rules-skill/agent-rules"},"updatedAt":"2026-05-01T12:57:16.400Z"}}