One-click install
npx skills add https://github.com/netresearch/agents-skill --skill agents
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: agents
Source: https://github.com/netresearch/agents-skill/tree/main/.
Command: npx skills add https://github.com/netresearch/agents-skill --skill agents

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires jq, and includes scripts (resource) and references (resource) components.

What problem does it solves? Manual creation and maintenance of AGENTS.md files is time-consuming, error-prone, and leads to inconsistent documentation across projects. This lack of standardization hinders efficient onboarding for both human developers and AI agents, making it difficult for them to quickly understand project conventions, build processes, and interaction patterns.

Core Features & Use Cases

  • Automated Hierarchical Documentation: Generates thin root AGENTS.md files for global rules and auto-creates scoped files for specific subsystems (e.g., backend/, frontend/, cmd/), ensuring a clear, structured overview.
  • Intelligent Project Analysis: Automatically detects project language (Go, PHP, TypeScript, Python, hybrid), frameworks, and extracts build, test, lint, and format commands from Makefile, package.json, composer.json, and go.mod.
  • Idempotent & Safe Updates: Updates existing AGENTS.md files by refreshing auto-extracted content and timestamps, while preserving any custom modifications made by users, making it safe to run repeatedly.
  • Use Case: For a new multi-language repository, use this skill to instantly generate a comprehensive AGENTS.md documentation suite. This provides AI agents with immediate, structured context for code generation, review, and task execution, while also streamlining human developer onboarding by centralizing project guidelines.

Quick Start

Generate AGENTS.md files for your current project, including a thin root and auto-detected scoped files.

Frequently Asked Questions about agents

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automatically generate AGENTS.md documentation for my project?

Generate AGENTS.md files by running this Skill on your project root. It auto-detects your language (Go, PHP, TypeScript, Python, or hybrid), extracts commands from Makefile, package.json, composer.json, and go.mod, then creates a root AGENTS.md plus scoped files for each subsystem, standardizing AI agent and developer onboarding.

Can I use AGENTS.md to document multi-language projects?

Yes. This Skill supports hybrid projects combining Go, PHP, TypeScript, and Python. It analyzes each language's build configuration, generates language-specific templates, and creates hierarchical AGENTS.md files (root plus scoped) that capture conventions for all languages in one structure.

Does AGENTS.md generation preserve my existing documentation?

Yes, updates are idempotent and safe. The Skill refreshes auto-extracted content and timestamps while preserving custom modifications you've made. You can run it repeatedly without losing edits, making it safe for continuous maintenance.

What project files does the Skill analyze to extract commands?

The Skill reads Makefile, package.json, composer.json, and go.mod to detect build, test, lint, and format commands. It automatically identifies which files exist in your project and extracts relevant tooling and workflows for your specific tech stack.

How does hierarchical AGENTS.md structure improve AI agent workflows?

Hierarchical structure—a thin root file plus scoped AGENTS.md files for subsystems (backend, frontend, cmd)—gives AI agents a clear, modular context. This enables precise task execution, faster code generation, and improved review by segmenting project conventions by component.

What happens if my project doesn't have a Makefile or package.json?

The Skill auto-detects available configuration files. If only go.mod exists, it extracts Go commands. If only composer.json exists, it extracts PHP commands. It generates AGENTS.md based on whatever dependency and build files are present in your project.