write-agents-md

Generate standardized AGENTS.md templates with validated skill references.

15|Updated Dec 25, 2025
One-click install
npx skills add https://github.com/aalmada/BookStore --skill write-agents-md
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: write-agents-md
Source: https://github.com/aalmada/BookStore/tree/main/.claude/skills/write-agents-md
Command: npx skills add https://github.com/aalmada/BookStore --skill write-agents-md

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill streamlines the creation and maintenance of AGENTS.md files, ensuring consistent structure, skill references, and adherence to best practices across projects.

Core Features & Use Cases

  • Template-driven AGENTS.md layouts for new repositories, monorepos, and subdirectories
  • Validates and links to available skills in .claude/skills/
  • Enforces a 150-line limit and promotes concise, actionable guidance
  • Use Case: When standardizing agent instructions across a multi-package project

Quick Start

Generate or update AGENTS.md for a directory by running the scaffolding workflow with the templates and checks.

Frequently Asked Questions about write-agents-md

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

FAQPage Schema
How do I generate an AGENTS.md file for a monorepo with multiple subdirectories?

AGENTS.md standardizes agent instructions, prompts, and reference sections across a repository to ensure consistent interactions and best practices, acting as a central configuration file for automated workflows.

What is the best way to keep AGENTS.md concise for automated agents?

The best way to keep AGENTS.md concise is to enforce a strict 150-line limit using template-driven layouts that promote actionable guidance and validate all linked skills exist under the .claude/skills directory.

Can I use hierarchical AGENTS.md files for individual packages in a monorepo?

Yes, you can use hierarchical AGENTS.md files for individual packages in a monorepo, as the scaffolding supports nested directory overrides to apply specific agent instructions and references at each package level.

Why does my AGENTS.md reference a skill that agents cannot find?

To validate skill references in AGENTS.md, run the template scaffolding workflow, which automatically checks that every referenced skill exists under the .claude/skills directory before finalizing the documentation structure.