agent-rules

Original：🇺🇸 English

Translated

51 scriptsChecked / no sensitive code detected

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.

2installs

Sourcenetresearch/agent-rules-skill

Added on2026-03-28

NPX Install

npx skill4agent add netresearch/agent-rules-skill agent-rules

SKILL.md Content

View Translation Comparison →

AGENTS.md Generator Skill

Generate and maintain AGENTS.md files following the agents.md convention. AGENTS.md is FOR AGENTS, not humans.

When to Use

Creating or updating AGENTS.md for new/existing projects
Standardizing agent documentation across repositories
Checking if AGENTS.md files are current with recent code changes
Onboarding AI agents to an unfamiliar codebase

Scripts

Script	Purpose
`scripts/generate-agents.sh PATH`	Generate AGENTS.md files
`scripts/validate-structure.sh PATH`	Validate structure compliance
`scripts/check-freshness.sh PATH`	Check if files are outdated
`scripts/verify-content.sh PATH`	Verify documented files/commands match codebase
`scripts/verify-commands.sh PATH`	Verify documented commands execute
`scripts/detect-project.sh PATH`	Detect language, version, build tools
`scripts/detect-scopes.sh PATH`	Identify directories needing scoped files
`scripts/extract-commands.sh PATH`	Extract commands from build configs
`scripts/extract-ci-rules.sh PATH`	Extract CI quality gates and version matrix
`scripts/extract-architecture-rules.sh PATH`	Extract module boundaries
`scripts/extract-adrs.sh PATH`	Extract architectural decision records
`scripts/extract-github-rulesets.sh PATH`	Extract GitHub rulesets and merge rules

See

references/scripts-guide.md

for full options.

Core Principles

Structured over Prose -- tables parse faster than paragraphs
Verified Commands -- commands that don't work waste tokens
Pointer Principle -- point to files, don't duplicate content
Auto Symlinks -- CLAUDE.md/GEMINI.md symlinks created by default (see
```
ai-tool-compatibility.md
```
)

References

File	Contents
`verification-guide.md`	Verification steps, design principles
`scripts-guide.md`	Script options, validation checklist
`ai-tool-compatibility.md`	16-agent compatibility matrix
`output-structure.md`	Root/scoped sections
`git-hooks-setup.md`	Hook framework detection and setup
`examples/`	Complete examples

Templates

Root:

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

Supported Projects

Go, PHP (Composer/Laravel/Symfony/TYPO3/Oro), TypeScript (React/Next/Vue/Node), Python (pip/poetry/ruff/mypy), Skill repos, Hybrid (multi-stack with auto-scoping).