agents-md

Creates and maintains concise AGENTS.md files that reference local agent skills.

1|Updated Apr 16, 2026
One-click install
npx skills add https://github.com/klh/skills --skill agents-md-klh
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: agents-md
Source: https://github.com/klh/skills/tree/main/.well-known/agent-skills/agents-md
Command: npx skills add https://github.com/klh/skills --skill agents-md-klh

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Agent-facing documentation often becomes bloated with duplicated instructions, filler prose, and outdated guidance. This Skill enforces a minimal, structured style for AGENTS.md files so coding agents get exactly the project context they need without redundancy. ## Core Features & Use Cases - Structured AGENTS.md authoring: Generates required sections such as Package Manager, Commit Attribution, Key Conventions, and Local Skills references. - Local skill discovery: Scans .claude/skills and plugin directories for SKILL.md files so AGENTS.md can reference skills instead of duplicating their content. - Style enforcement: Applies writing rules (headers and bullets only, no filler, reference-don't-duplicate) and lists anti-patterns to avoid. - Use Case: When setting up a new repository, ask the agent to create an AGENTS.md; it discovers installed skills, writes concise sections, and symlinks CLAUDE.md to AGENTS.md. ## Quick Start Ask the agent to create an AGENTS.md for this project that references the local skills and follows the minimal documentation style.

Frequently Asked Questions about agents-md

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

FAQPage Schema
How do I create an AGENTS.md file for my project?▼

Create AGENTS.md at the project root with required sections: Package Manager, Commit Attribution, Key Conventions, and Local Skills. Use headers and bullets only, reference skills instead of duplicating content, and symlink CLAUDE.md to AGENTS.md.

What sections should an AGENTS.md file include?▼

Required sections are Package Manager, Commit Attribution, Key Conventions, and Local Skills referencing discovered SKILL.md files. Optional sections like API route templates or CLI command tables should be added only when truly needed.

How do I reference local skills in AGENTS.md?▼

Discover skills by finding SKILL.md files under .claude/skills or plugin directories, read each frontmatter, then add short references like "Use `db-migrate` skill. See `.claude/skills/db-migrate/SKILL.md`" instead of copying skill content.

Should CLAUDE.md and AGENTS.md be separate files?▼

No. AGENTS.md is the canonical agent-facing documentation, and CLAUDE.md should be a symlink to it created with `ln -s AGENTS.md CLAUDE.md`. This keeps a single source of truth for agent instructions.

What should I avoid when writing agent documentation?▼

Avoid welcome intros, pleasantries, long prose paragraphs, obvious instructions like "write clean code", and content duplicated from skills. Keep instructions as headers and bullets, state what to do without explaining why, and trust agent capabilities.