{"id":45764315,"url":"https://github.com/netresearch/agent-rules-skill","last_synced_at":"2026-03-17T21:08:38.366Z","repository":{"id":324224321,"uuid":"1078959689","full_name":"netresearch/agent-rules-skill","owner":"netresearch","description":"Agent Skill for generating AGENTS.md files following the agents.md convention | Claude Code compatible","archived":false,"fork":false,"pushed_at":"2026-03-11T12:35:10.000Z","size":421,"stargazers_count":16,"open_issues_count":2,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-03-11T12:47:05.794Z","etag":null,"topics":["agent-skills","agents-md","ai-agent","ai-agents","claude-code-skill","convention","documentation","open-standard","skill"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/netresearch.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2025-10-18T19:35:16.000Z","updated_at":"2026-03-11T12:35:14.000Z","dependencies_parsed_at":"2026-01-29T20:00:37.631Z","dependency_job_id":null,"html_url":"https://github.com/netresearch/agent-rules-skill","commit_stats":null,"previous_names":["netresearch/agents-skill","netresearch/agent-rules-skill"],"tags_count":33,"template":false,"template_full_name":null,"purl":"pkg:github/netresearch/agent-rules-skill","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/netresearch%2Fagent-rules-skill","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/netresearch%2Fagent-rules-skill/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/netresearch%2Fagent-rules-skill/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/netresearch%2Fagent-rules-skill/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/netresearch","download_url":"https://codeload.github.com/netresearch/agent-rules-skill/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/netresearch%2Fagent-rules-skill/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30631458,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-17T17:32:55.572Z","status":"ssl_error","status_checked_at":"2026-03-17T17:32:38.732Z","response_time":56,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agent-skills","agents-md","ai-agent","ai-agents","claude-code-skill","convention","documentation","open-standard","skill"],"created_at":"2026-02-26T00:02:35.695Z","updated_at":"2026-03-17T21:08:38.360Z","avatar_url":"https://github.com/netresearch.png","language":"Shell","readme":"# AGENTS.md Generator Skill\n\nNetresearch AI skill for generating and maintaining AGENTS.md files following the [agents.md specification](https://agents.md/).\n\n\u003e **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](https://agents.md/) and [best practices from 2,500+ repositories](https://github.blog/ai-and-ml/github-copilot/how-to-write-a-great-agents-md-lessons-from-over-2500-repositories/).\n\n## Standards Compliance\n\nThis skill implements two complementary standards:\n\n1. **[agents.md](https://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.\n\n2. **[Agent Skills](https://agentskills.io)** - How this skill is packaged and distributed. A portable format for procedural knowledge that works across AI agents.\n\n**Supported Platforms:**\n- ✅ Claude Code (Anthropic)\n- ✅ Cursor\n- ✅ GitHub Copilot\n- ✅ Other skills-compatible AI agents\n\n\n## Features\n\n- **Thin Root Files** - ~30 lines with precedence rules and global defaults\n- **Scoped Files** - Automatic subsystem detection (backend/, frontend/, internal/, cmd/)\n- **Auto-Extraction** - Commands from Makefile, package.json, composer.json, go.mod\n- **Multi-Language** - Templates for Go, PHP, TypeScript, Python, and hybrid projects\n- **Idempotent Updates** - Preserve existing structure while refreshing content\n- **Managed Headers** - Mark files as agent-maintained with timestamps\n\n## Installation\n\n### Marketplace (Recommended)\n\nAdd the [Netresearch marketplace](https://github.com/netresearch/claude-code-marketplace) once, then browse and install skills:\n\n```bash\n# Claude Code\n/plugin marketplace add netresearch/claude-code-marketplace\n```\n\n### npx ([skills.sh](https://skills.sh))\n\nInstall with any [Agent Skills](https://agentskills.io)-compatible agent:\n\n```bash\nnpx skills add https://github.com/netresearch/agent-rules-skill --skill agent-rules\n```\n\n### Download Release\n\nDownload the [latest release](https://github.com/netresearch/agent-rules-skill/releases/latest) and extract to your agent's skills directory.\n\n### Git Clone\n\n```bash\ngit clone https://github.com/netresearch/agent-rules-skill.git\n```\n\n### Composer (PHP Projects)\n\n```bash\ncomposer require netresearch/agent-rules-skill\n```\n\nRequires [netresearch/composer-agent-skill-plugin](https://github.com/netresearch/composer-agent-skill-plugin).\n## Usage\n\nThe skill triggers on keywords like:\n- \"AGENTS.md\", \"agents file\"\n- \"agent documentation\", \"AI onboarding\"\n- \"project context for AI\"\n\n### Example Prompts\n\n```\n\"Generate AGENTS.md for this project\"\n\"Update the agents documentation\"\n\"Create scoped AGENTS.md files for each subsystem\"\n\"Validate AGENTS.md structure\"\n```\n\n## Supported Projects\n\n| Type | Detection | Features |\n|------|-----------|----------|\n| Go | `go.mod` | Version extraction, CLI tool detection |\n| PHP | `composer.json` | TYPO3/Laravel/Symfony detection |\n| TypeScript | `package.json` | React/Next.js/Vue/Express detection |\n| Python | `pyproject.toml` | Poetry/Ruff/Django/Flask detection |\n| Hybrid | Multiple markers | Auto-creates scoped files per stack |\n\n## Structure\n\n```\nagents/\n├── SKILL.md              # AI instructions\n├── README.md             # This file\n├── LICENSE-MIT           # Code license (MIT)\n├── LICENSE-CC-BY-SA-4.0  # Content license (CC-BY-SA-4.0)\n├── composer.json         # PHP distribution\n├── references/           # Convention documentation\n├── scripts/              # Generator scripts\n│   ├── generate-agents.sh\n│   ├── validate-structure.sh\n│   └── detect-scopes.sh\n└── templates/            # Language-specific templates\n    ├── go/\n    ├── php/\n    ├── typescript/\n    └── python/\n```\n\n## Contributing\n\nContributions welcome! Please submit PRs for:\n- Additional language templates\n- Detection signal improvements\n- Script enhancements\n- Documentation updates\n\n## License\n\nThis project uses split licensing:\n\n- **Code** (scripts, workflows, configs): [MIT](LICENSE-MIT)\n- **Content** (skill definitions, documentation, references): [CC-BY-SA-4.0](LICENSE-CC-BY-SA-4.0)\n\nSee the individual license files for full terms.\n## Credits\n\nDeveloped and maintained by [Netresearch DTT GmbH](https://www.netresearch.de/).\n\n---\n\n**Made with ❤️ for Open Source by [Netresearch](https://www.netresearch.de/)**\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnetresearch%2Fagent-rules-skill","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnetresearch%2Fagent-rules-skill","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnetresearch%2Fagent-rules-skill/lists"}