agents-md

agents-md is an open-source docs skill for Claude Code and compatible agents, published by sickn33. Its author describes it as: “This skill should be used when the user asks to "create AGENTS.md", "update AGENTS.md", "maintain agent docs", "set up CLAUDE.md", or needs to keep agent instructions concise. Enforces research-backed best practices f…”. The project has 45k stars on GitHub and is available under the MIT license. Add it to your setup with `/plugin marketplace add sickn33/agentic-awesome-skills`.

What agents-md does

AGENTS.md is the canonical agent-facing documentation. Keep it minimal—agents are capable and don't need hand-holding. Target under 60 lines; never exceed 100. Instruction-following quality degrades as document length increases.

Installation

Add agents-md to your agent with:

/plugin marketplace add sickn33/agentic-awesome-skills

Always review a skill's source before installing it. This command comes from the skill's public repository; the linked repo is the source of truth for exact setup steps.

What's inside

The SKILL.md for agents-md is organised into these sections:

• When to Use
• File Setup
• Before Writing
• Writing Rules
• Required Sections
• Package Manager
• File-Scoped Commands
• Commit Attribution
• Key Conventions
• Optional Sections
• Anti-Patterns
• Example Structure

When to use it

Reach for agents-md when you want docs help from your agent without writing the same instructions every session. Load the skill and the agent picks it up automatically for relevant tasks.

Strengths

• Clear MIT license — safe to read and adapt
• Ships in sickn33/agentic-awesome-skills, an established project with 45,044 GitHub stars
• Actively maintained (recent commits)

Topics

Frequently asked questions

What does agents-md do?

This skill should be used when the user asks to "create AGENTS.md", "update AGENTS.md", "maintain agent docs", "set up CLAUDE.md", or needs to keep agent instructions concise. Enforces research-backed best practices for minimal, high-signal agent documentation.

How do I install agents-md?

Run /plugin marketplace add sickn33/agentic-awesome-skills in your agent, then reload your skills. Review the source at https://github.com/sickn33/agentic-awesome-skills before installing.

Is agents-md free to use?

Yes. agents-md is free and open source under the MIT license, so you can read, run, and adapt it within that license's terms.

Where does agents-md come from?

agents-md ships inside sickn33/agentic-awesome-skills, a repository that contains 66 catalogued skills in total. The repository's 45,044 GitHub stars apply to that whole collection, not to this skill on its own.