Overview
agents-md is an open-source workflow skill for Claude Code and compatible agents, published by sickn33. Its author describes it as: “Create, revise, or audit AGENTS.md files from repository evidence, verified commands, and correctly scoped instructions without overwriting maintainer intent.”. The project has 46k 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
Create or improve agent instructions that help a coding agent change the repository correctly without rediscovering its workflow. Base every repository-specific command, path, and rule on evidence in the current checkout.
What’s inside
The SKILL.md for agents-md is organised into these sections:
- Overview
- When to Use
- How It Works
- 1. Preserve existing intent
- 2. Build a bounded evidence map
- 3. Choose the instruction scope
- 4. Write high-signal guidance
- 5. Validate before handoff
- Examples
- Create a focused root file
- Revise without erasing policy
- Best Practices
Installation
Add agents-md to your agent with:
/plugin marketplace add sickn33/agentic-awesome-skillsReview a skill’s source before installing it — skills can instruct your agent to run commands. This command comes from the skill’s public repository, which is the source of truth for setup steps. New to skills? Read how to install Claude Code skills.
Supported agents
- Claude Code — ships a claude code plugin marketplace
- Codex — declared in the repository topics
- Cursor — declared in the repository topics
- Gemini CLI — declared in the repository topics
- Antigravity — declared in the repository topics
License
agents-md is published under the MIT license.
Strengths
- Clear MIT license — safe to read and adapt within its terms
- Ships in sickn33/agentic-awesome-skills, an established project with 46,389 GitHub stars
- Works with Claude Code, Codex, Cursor, Gemini CLI, Antigravity
- Actively maintained — repository updated in the last 30 days
- Its repository gained 2,178 GitHub stars over the last 45 days
Author
Topics
Frequently asked questions
- What does agents-md do?
- Create, revise, or audit AGENTS.md files from repository evidence, verified commands, and correctly scoped instructions without overwriting maintainer intent.
- 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.
- Which agents does agents-md work with?
- agents-md lists Claude Code, Codex, Cursor, Gemini CLI, and Antigravity — named in its SKILL.md, its plugin marketplace or its repository topics. Skills use the portable SKILL.md format, so other agents that read that format may load it too.
- Where does agents-md come from?
- agents-md ships inside sickn33/agentic-awesome-skills, a repository that contains 70 catalogued skills in total. The repository's 46,389 GitHub stars apply to that whole collection, not to this skill on its own.