{"id":42752041,"url":"https://github.com/netresearch/agents-skill","last_synced_at":"2026-02-25T16:04:31.906Z","repository":{"id":324224321,"uuid":"1078959689","full_name":"netresearch/agents-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-02-24T13:01:17.000Z","size":441,"stargazers_count":14,"open_issues_count":1,"forks_count":2,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-02-24T17:20:25.987Z","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-02-24T13:01:20.000Z","dependencies_parsed_at":"2026-01-29T20:00:37.631Z","dependency_job_id":null,"html_url":"https://github.com/netresearch/agents-skill","commit_stats":null,"previous_names":["netresearch/agents-skill"],"tags_count":30,"template":false,"template_full_name":null,"purl":"pkg:github/netresearch/agents-skill","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/netresearch%2Fagents-skill","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/netresearch%2Fagents-skill/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/netresearch%2Fagents-skill/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/netresearch%2Fagents-skill/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/netresearch","download_url":"https://codeload.github.com/netresearch/agents-skill/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/netresearch%2Fagents-skill/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29829411,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-25T15:41:19.027Z","status":"ssl_error","status_checked_at":"2026-02-25T15:40:47.150Z","response_time":61,"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-01-29T20:00:16.317Z","updated_at":"2026-02-25T16:04:31.882Z","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### Option 1: Via Netresearch Marketplace (Recommended)\n\n```bash\nclaude mcp add-json netresearch-skills-bundle '{\"type\":\"url\",\"url\":\"https://raw.githubusercontent.com/netresearch/claude-code-marketplace/main/.claude-plugin/marketplace.json\"}'\n```\n\nThen browse skills with `/plugin`.\n\n### Option 2: Download Release\n\nDownload the [latest release](https://github.com/netresearch/agents-skill/releases/latest) and extract to `~/.claude/skills/agents/`\n\n### Option 3: Composer (PHP projects)\n\n```bash\ncomposer require netresearch/agent-agents\n```\n\n**Requires:** [netresearch/composer-agent-skill-plugin](https://github.com/netresearch/composer-agent-skill-plugin)\n\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               # GPL-2.0-or-later\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\nGPL-2.0-or-later - See [LICENSE](LICENSE) for details.\n\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%2Fagents-skill","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnetresearch%2Fagents-skill","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnetresearch%2Fagents-skill/lists"}