agents-md

Create and maintain minimal AGENTS.md documentation with frontmatter and symlinked CLAUDE.md.

9|Updated Apr 3, 2026
One-click install
npx skills add https://github.com/klh/speedy-claude --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/speedy-claude/tree/main/skills/agents-md
Command: npx skills add https://github.com/klh/speedy-claude --skill agents-md-klh

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

AGENTS.md is the canonical agent-facing documentation. This skill provides a lightweight, consistent blueprint to create and maintain AGENTS.md at the project root, and to reference standardized agent guidelines across the workspace.

Core Features & Use Cases

  • Enforces a minimal, consistent AGENTS.md structure with a frontmatter that defines name and description.
  • Guides discovery of local skills and references to neighbor SKILL.md entries, enabling cross-skill documentation.
  • Supports linking CLAUDE.md via a symlink to maintain a single source of agent instructions.

Quick Start

Create AGENTS.md at the project root and symlink CLAUDE.md

Frequently Asked Questions about agents-md

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

FAQPage Schema
How do I create and maintain consistent AGENTS.md documentation for my project?

To create AGENTS.md documentation, you can use a skill that automates a minimal, consistent blueprint at the project root. It enforces a frontmatter-driven entry with mandatory name and description fields, ensuring concise, non-redundant agent-facing documentation across your codebase.

What is the purpose of an AGENTS.md file and when do I need one?

An AGENTS.md file serves as canonical agent-facing documentation for environments where agents must discover local skills and reference standardized rules. You need it when agents require a consistent, concise entry point to navigate your project's guidelines and cross-skill documentation.

How do I link AGENTS.md and CLAUDE.md to maintain a single source of agent instructions?

You can link AGENTS.md and CLAUDE.md by creating a symlink at the project root. This approach maintains a single source of agent instructions, ensuring that both reference points stay synchronized without redundant documentation.

Can I use this approach to help agents discover local skills and reference neighbor SKILL.md entries?

Yes, this approach explicitly supports agent discovery of local skills and references to neighbor SKILL.md entries. It provides a structured section within AGENTS.md to enable cross-skill documentation and guide agents to relevant standardized guidelines.

What is the best way to enforce a minimal, non-redundant documentation style for agent guidelines?

The best way to enforce a minimal documentation style is applying a standardized AGENTS.md blueprint with a frontmatter-driven entry. This structure mandates concise sections and optional references to related skills, preventing redundant agent-facing instructions across the workspace.

Does AGENTS.md require specific frontmatter fields to function properly?

Yes, AGENTS.md requires a frontmatter-driven entry with mandatory name and description fields. This consistent frontmatter structure ensures agents can properly parse and identify the documentation's purpose and scope within the project root.