Netresearch AI skill for generating and maintaining AGENTS.md files following the agents.md specification.

What is AGENTS.md? A context file written for AI coding agents, not humans. Human readability is a side effect, not a goal. Adopted by 60,000+ open-source projects. See the official specification and best practices from 2,500+ repositories.

This skill implements two complementary standards:

1. agents.md - The file format this skill generates. A simple Markdown convention for guiding AI coding agents, supported by Claude Code, GitHub Copilot, Cursor, and 60,000+ open-source projects.

2. Agent Skills - How this skill is packaged and distributed. A portable format for procedural knowledge that works across AI agents.

Supported Platforms:

• ✅ Claude Code (Anthropic)
• ✅ Cursor
• ✅ GitHub Copilot
• ✅ Other skills-compatible AI agents

• Thin Root Files - ~30 lines with precedence rules and global defaults
• Scoped Files - Automatic subsystem detection (backend/, frontend/, internal/, cmd/)
• Auto-Extraction - Commands from Makefile, package.json, composer.json, go.mod
• Multi-Language - Templates for Go, PHP, TypeScript, Python, and hybrid projects
• Idempotent Updates - Preserve existing structure while refreshing content
• Managed Headers - Mark files as agent-maintained with timestamps

claude mcp add-json netresearch-skills-bundle '{"type":"url","url":"https://raw.githubusercontent.com/netresearch/claude-code-marketplace/main/.claude-plugin/marketplace.json"}'

Then browse skills with /plugin.

Download the latest release and extract to ~/.claude/skills/agents/

composer require netresearch/agent-agents

Requires: netresearch/composer-agent-skill-plugin

The skill triggers on keywords like:

• "AGENTS.md", "agents file"
• "agent documentation", "AI onboarding"
• "project context for AI"

"Generate AGENTS.md for this project"
"Update the agents documentation"
"Create scoped AGENTS.md files for each subsystem"
"Validate AGENTS.md structure"

agents/
├── SKILL.md              # AI instructions
├── README.md             # This file
├── LICENSE               # GPL-2.0-or-later
├── composer.json         # PHP distribution
├── references/           # Convention documentation
├── scripts/              # Generator scripts
│   ├── generate-agents.sh
│   ├── validate-structure.sh
│   └── detect-scopes.sh
└── templates/            # Language-specific templates
    ├── go/
    ├── php/
    ├── typescript/
    └── python/

Contributions welcome! Please submit PRs for:

• Additional language templates
• Detection signal improvements
• Script enhancements
• Documentation updates

GPL-2.0-or-later - See LICENSE for details.

Developed and maintained by Netresearch DTT GmbH.

Made with ❤️ for Open Source by Netresearch