agent-rules

Category: Tools & Productivity | Uploader: netresearch | Downloads: 0 | Version: v1.0（Latest）

Use when creating or updating AGENTS.md files, .github/copilot-instructions.md, or other AI agent rule files, onboarding AI agents to a project, or standardizing agent documentation across repositories.

Changelog: Source: GitHub https://github.com/netresearch/agent-rules-skill

Directory Structure

Current level: skills/agent-rules/

📁 assets/
- 📁 example-workflows/
  - 📄 validate-agents.yml 2.7 KB
- 📁 scoped/
  - 📄 backend-go.md 2.8 KB
  - 📄 backend-php.md 2.9 KB
  - 📄 backend-python.md 2.6 KB
  - 📄 backend-typescript.md 2.8 KB
  - 📄 claude-code-skill.md 3.4 KB
  - 📄 cli.md 2.7 KB
  - 📄 concourse.md 5.2 KB
  - 📄 ddev.md 2.4 KB
  - 📄 docker.md 5.3 KB
  - 📄 documentation.md 3.5 KB
  - 📄 examples.md 3.4 KB
  - 📄 frontend-typescript.md 2.7 KB
  - 📄 github-actions.md 5.2 KB
  - 📄 gitlab-ci.md 4.6 KB
  - 📄 oro-bundle.md 6.5 KB
  - 📄 oro-project.md 5.5 KB
  - 📄 resources.md 3.5 KB
  - 📄 symfony.md 5.3 KB
  - 📄 testing.md 3.0 KB
  - 📄 typo3-docs.md 3.6 KB
  - 📄 typo3-extension.md 5.1 KB
  - 📄 typo3-project.md 4.7 KB
  - 📄 typo3-testing.md 3.0 KB
- 📄 root-thin.md 3.5 KB
- 📄 root-verbose.md 3.8 KB
📁 references/
- 📁 examples/
  - 📁 coding-agent-cli/
    
    📄 AGENTS.md 2.5 KB
    
    📄 go.mod 45 B
    
    📄 scripts-AGENTS.md 10.1 KB
  - 📁 express-api-ts/
    
    📁 src/
    
    📁 controllers/
    
    📄 userController.ts 2.1 KB
    
    📁 middleware/
    
    📄 errorHandler.ts 1.0 KB
    
    📄 requestLogger.ts 471 B
    
    📁 routes/
    
    📄 health.ts 428 B
    
    📄 users.ts 397 B
    
    📁 utils/
    
    📄 errors.ts 1.2 KB
    
    📄 logger.ts 441 B
    
    📄 AGENTS.md 3.1 KB
    
    📄 config.ts 917 B
    
    📄 index.ts 671 B
    
    📄 .env.example 232 B
    
    📄 AGENTS.md 3.1 KB
    
    📄 package.json 757 B
    
    📄 pnpm-lock.yaml 101 B
    
    📄 tsconfig.json 630 B
  - 📁 fastapi-app/
    
    📁 src/
    
    📁 models/
    
    📄 __init__.py 278 B
    
    📄 item.py 1.0 KB
    
    📄 user.py 922 B
    
    📁 routes/
    
    📄 __init__.py 110 B
    
    📄 health.py 470 B
    
    📄 items.py 1.9 KB
    
    📄 users.py 1.7 KB
    
    📁 services/
    
    📄 __init__.py 174 B
    
    📄 item_service.py 2.5 KB
    
    📄 user_service.py 2.1 KB
    
    📄 __init__.py 58 B
    
    📄 AGENTS.md 2.9 KB
    
    📄 config.py 1.1 KB
    
    📄 main.py 1.5 KB
    
    📄 .env.example 348 B
    
    📄 AGENTS.md 3.2 KB
    
    📄 pyproject.toml 1.8 KB
    
    📄 uv.lock 136 B
  - 📁 go-api-with-react-admin/
    
    📁 admin/
    
    📁 src/
    
    📄 App.tsx 101 B
    
    📄 package.json 422 B
    
    📁 cmd/
    
    📁 api/
    
    📄 main.go 75 B
    
    📄 .scopes 93 B
    
    📄 AGENTS.md 3.0 KB
    
    📄 go.mod 31 B
    
    📄 main.go 71 B
  - 📁 go-with-internal-web-tsx/
    
    📁 internal/
    
    📁 web/
    
    📁 src/
    
    📄 App.tsx 57 B
    
    📄 Button.tsx 63 B
    
    📄 Footer.tsx 63 B
    
    📄 Header.tsx 63 B
    
    📄 Sidebar.tsx 65 B
    
    📄 AGENTS.md 3.1 KB
    
    📄 package.json 328 B
    
    📄 .scopes 102 B
    
    📄 AGENTS.md 3.1 KB
    
    📄 go.mod 34 B
    
    📄 main.go 85 B
    
    📄 package-lock.json 0 B
    
    📄 package.json 192 B
  - 📁 ldap-selfservice/
    
    📄 AGENTS.md 2.5 KB
    
    📄 go.mod 45 B
    
    📄 internal-AGENTS.md 10.0 KB
    
    📄 internal-web-AGENTS.md 12.1 KB
  - 📁 php-with-frontend/
    
    📁 src/
    
    📄 Controller.php 41 B
    
    📁 web/
    
    📁 src/
    
    📄 App.tsx 63 B
    
    📄 Button.tsx 215 B
    
    📄 Footer.tsx 125 B
    
    📄 Header.tsx 122 B
    
    📄 main.tsx 68 B
    
    📄 AGENTS.md 3.1 KB
    
    📄 package.json 489 B
    
    📄 tsconfig.json 280 B
    
    📄 .scopes 89 B
    
    📄 AGENTS.md 3.1 KB
    
    📄 composer.json 185 B
    
    📄 package.json 277 B
    
    📄 pnpm-lock.yaml 0 B
  - 📁 pnpm-workspace/
    
    📁 packages/
    
    📁 web/
    
    📁 src/
    
    📄 index.ts 258 B
    
    📄 package.json 187 B
    
    📄 AGENTS.md 2.6 KB
    
    📄 package.json 105 B
    
    📄 pnpm-lock.yaml 920 B
    
    📄 pnpm-workspace.yaml 27 B
  - 📁 simple-ldap-go/
    
    📄 AGENTS.md 2.5 KB
    
    📄 examples-AGENTS.md 1.8 KB
    
    📄 go.mod 43 B
  - 📁 t3x-rte-ckeditor-image/
    
    📄 AGENTS.md 2.5 KB
    
    📄 Classes-AGENTS.md 12.0 KB
    
    📄 composer.json 174 B
- 📄 ai-tool-compatibility.md 1.7 KB
- 📄 analysis.md 10.8 KB
- 📄 directory-coverage.md 1.7 KB
- 📄 output-structure.md 3.8 KB
- 📄 scripts-guide.md 4.7 KB
- 📄 verification-guide.md 5.5 KB
📁 scripts/
- 📁 lib/
  - 📄 config-root.sh 5.8 KB
  - 📄 summary.sh 10.7 KB
  - 📄 template.sh 13.1 KB
- 📄 analyze-git-history.sh 9.8 KB
- 📄 check-freshness.sh 6.3 KB
- 📄 detect-golden-samples.sh 5.3 KB
- 📄 detect-heuristics.sh 3.2 KB
- 📄 detect-project.sh 19.3 KB
- 📄 detect-scopes.sh 11.4 KB
- 📄 detect-utilities.sh 4.3 KB
- 📄 extract-agent-configs.sh 9.2 KB
- 📄 extract-ci-commands.sh 12.5 KB
- 📄 extract-commands.sh 11.0 KB
- 📄 extract-documentation.sh 7.7 KB
- 📄 extract-github-settings.sh 3.3 KB
- 📄 extract-ide-settings.sh 7.0 KB
- 📄 extract-platform-files.sh 7.9 KB
- 📄 extract-quality-configs.sh 14.8 KB
- 📄 generate-agents.sh 93.1 KB
- 📄 generate-file-map.sh 4.4 KB
- 📄 validate-structure.sh 7.3 KB
- 📄 verify-commands.sh 21.3 KB
- 📄 verify-content.sh 9.5 KB
📄 AGENTS.md 3.9 KB
📄 checkpoints.yaml 7.0 KB
📄 SKILL.md 3.8 KB

SKILL.md

---
name: agent-rules
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, or standardizing agent documentation across repositories."
---

# AGENTS.md Generator Skill

## Overview

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 a new project and establishing baseline AGENTS.md
- Standardizing existing projects with consistent agent documentation
- Ensuring multi-repo consistency across repositories
- Checking if AGENTS.md files are current with recent code changes
- Onboarding AI agents to an unfamiliar codebase

## Quick Reference

| 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 vs git commits |
| `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 |

See `references/scripts-guide.md` for full options and validation checklist.

## Core Principles

- **Structured over Prose** -- tables and maps parse faster than paragraphs
- **Verified Commands** -- commands that don't work waste 500+ tokens debugging
- **Pointer Principle** -- point to files, don't duplicate content
- **Golden Samples** -- one example file beats pages of explanation
- **Audit Before Generating** -- discover existing docs and pain points before running scripts

## Language Choice

Default to English. Exception: match your code's naming language to prevent agents mixing languages.

## Prerequisites

| Requirement | Version | Notes |
|-------------|---------|-------|
| Bash | 4.3+ | Nameref variables (`local -n`). macOS: `brew install bash` |
| jq | 1.5+ | JSON processing |
| git | 2.0+ | For git history analysis |

## References

Detailed documentation in `references/`:

| File | Contents |
|------|----------|
| [`verification-guide.md`](references/verification-guide.md) | Verification steps, name matching, command verification, design principles |
| [`scripts-guide.md`](references/scripts-guide.md) | Script options, post-generation validation checklist |
| [`ai-tool-compatibility.md`](references/ai-tool-compatibility.md) | Claude Code shim, Codex stacking, Copilot integration |
| [`output-structure.md`](references/output-structure.md) | Root/scoped sections, auto-generate vs manual curation |
| [`analysis.md`](references/analysis.md) | Analysis of 21 real-world AGENTS.md files |
| [`directory-coverage.md`](references/directory-coverage.md) | Coverage guidance for PHP/TYPO3, Go, TypeScript |
| [`examples/`](references/examples/) | Complete examples (coding-agent-cli, ldap-selfservice, simple-ldap-go, t3x-rte-ckeditor-image) |

## Asset Templates

Root templates in `assets/`: `root-thin.md` (~30 lines, default), `root-verbose.md` (~100 lines).

Scoped templates in `assets/scoped/`: `backend-go.md`, `backend-php.md`, `typo3.md`, `oro.md`, `cli.md`, `frontend-typescript.md`.

## Supported Project Types

| Language | Project Types |
|----------|---------------|
| Go | Libraries, web apps (Fiber/Echo/Gin), CLI (Cobra/urfave) |
| PHP | Composer packages, Laravel/Symfony |
| PHP/TYPO3 | TYPO3 extensions (auto-detected via `ext_emconf.php`) |
| PHP/Oro | OroCommerce, OroPlatform, OroCRM bundles |
| TypeScript | React, Next.js, Vue, Node.js |
| Python | pip, poetry, Django, Flask, FastAPI |
| Hybrid | Multi-language projects (auto-creates scoped files per stack) |

Comments 0

Latest | Hot

Please login before commenting.

No comments yet. Be the first one!

agent-rules

Directory Structure

SKILL.md

Report

Notice