agents-md
Create and optimize AGENTS.md files for AI coding agents. Use when setting up agent instructions for a new project, improving existing AGENTS.md, or diagnosing why agents aren't following project conventions.
npx skills add majiayu000/claude-skill-registry --skill agents-md-pentaxis93-beadsmith-026d9a32 --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# AGENTS.md Authoring Skill ## What This Skill Does This skill guides the creation of effective AGENTS.md files - configuration files that provide persistent instructions to AI coding agents. A well-crafted AGENTS.md encodes project-specific knowledge that agents need to work effectively in your codebase. ### What AGENTS.md Solves 1. **Memory persistence** - LLMs don't retain context between sessions; AGENTS.md is loaded at session start 2. **Team standardization** - Shared via version control, ensures consistent AI behavior across team 3. **Reduced exploration overhead** - Agents immediately know build commands, conventions, gotchas 4. **Mistake prevention** - Explicit rules prevent common errors before they happen --- ## Quick Start For a simple project: ```markdown # Project Name ## Quick Reference | Task | Command | |------|---------| | Build | `npm run build` | | Test | `npm test` | | Lint | `npm run lint` | ## Code Style - TypeScript strict mode - 2-space indentation - Single quotes, no semicolons ## Gotchas - Use `httpx` not `requests` for HTTP calls - Database migrations are in `db/migrations/`, not project root ``` For complex projects, follow the phases below. --- ## Phas
- What This Skill Does
- What AGENTS.md Solves
- Quick Start
- Phase 1: Assessment
- Questions to Answer
- Scope Determination
- Check Existing Documentation
- Phase 2: Structure Selection
- File Hierarchy
- Recommended Sections
- Length Guidelines
- Phase 3: Writing Effective Instructions
- Instruction Types That Work
- Anti-Patterns to Avoid
Find existing docs that might inform AGENTS.md ls -la README.md CONTRIBUTING.md STYLE*.md .cursor* .claude* 2>/dev/null Add to .gitignore echo "AGENTS.local.md" >> .gitignore echo "**/AGENTS.local.md" >> .gitignore
What does the agents-md skill do?
Create and optimize AGENTS.md files for AI coding agents. Use when setting up agent instructions for a new project, improving existing AGENTS.md, or diagnosing why agents aren't following project conventions.
How do I install it?
Run `npx skills add majiayu000/claude-skill-registry --skill agents-md-pentaxis93-beadsmith-026d9a32 --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From majiayu000/claude-skill-registry, a repository with 534 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.