agents-md

Generate and maintain AGENTS.md and CLAUDE.md documentation for AI agents.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/promptlylabs/skills --skill agents-md-promptlylabs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: agents-md
Source: https://github.com/promptlylabs/skills/tree/main/plugins/promptly-skills/skills/agents-md
Command: npx skills add https://github.com/promptlylabs/skills --skill agents-md-promptlylabs

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

AGENTS.md (and CLAUDE.md) provide standardized, maintainable guidance for AI agents within a codebase. This Skill helps teams create, audit, and update agent instruction files to ensure consistent behavior and governance across repositories.

Core Features & Use Cases

  • Generate new AGENTS.md templates tailored to the repository structure and agent roles.
  • Review existing AGENTS.md for accuracy, completeness, and alignment with CLAUDE.md.
  • Update CLAUDE.md to reference the AGENTS.md and keep both documents in sync across all packages.

Quick Start

Generate a new AGENTS.md for the repository following the AGENTS.md workflow and ensure CLAUDE.md references are aligned.

Frequently Asked Questions about agents-md

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

FAQPage Schema
How do I generate AGENTS.md files for AI agent instructions in a codebase?

To generate AGENTS.md files for a codebase, you automate the creation of structured templates tailored to your repository structure and agent roles. This enforces consistent agent governance and maintainable AI instruction files across directories.

What is the best way to keep CLAUDE.md and AGENTS.md documentation in sync across a monorepo?

Keeping CLAUDE.md and AGENTS.md in sync across a monorepo requires updating CLAUDE.md to reference AGENTS.md and auditing both files for alignment. This ensures consistent AI agent behavior and governance across all packages.

How do I review existing AGENTS.md files for accuracy and completeness?

You review existing AGENTS.md documentation by auditing the files against a strict frontmatter schema and structured templates. This checks for accuracy, completeness, and alignment with CLAUDE.md to maintain proper agent instruction boundaries.

Do I need a strict frontmatter schema for AI agent documentation in multi-package repositories?

You need a strict frontmatter schema for AI agent documentation in multi-package repositories to enforce consistent agent governance. Standardized schemas ensure safety boundaries, root guidance, and commit conventions are uniformly applied across all directories.

When should I create separate AGENTS.md sub-files instead of a single root file?

You should create separate AGENTS.md sub-files instead of a single root file when managing monorepos that require directory-specific agent instructions. This approach enforces localized safety boundaries and structured guidance across different packages.