agents-md
Use when creating or updating AGENTS.md files to guide AI coding agents. Covers file structure, placement, content guidelines, and best practices for project-level agent instructions. USE FOR: project-specific agent instructions, build/test commands for agents, coding conventions, repository-level guidance DO NOT USE FOR: reusable cross-project skills (use agent-skills), agent runtime definition (use adl)
npx skills add majiayu000/claude-skill-registry --skill agents-md-tyler-r-kendrick-agent-skills --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 ## Overview AGENTS.md is a community convention for providing project-specific guidance to AI coding agents. Think of it as a README for agents — containing the tribal knowledge that senior engineers carry: build steps, test commands, architectural conventions, and coding standards. Adopted by 60,000+ open-source projects and supported by Claude Code, Codex, Gemini CLI, Jules, Factory, and Cursor. ## File Placement | Location | Scope | |----------|-------| | `AGENTS.md` (repo root) | Applies to the entire repository | | `src/AGENTS.md` | Applies to the `src/` directory and below | | `src/api/AGENTS.md` | Applies to `src/api/` specifically | Agents read the most specific AGENTS.md for the files they're working on, inheriting from parent directories. ## Recommended Structure ```markdown # AGENTS.md ## Build & Test - Build: `npm run build` - Test: `npm test` - Lint: `npm run lint` - Single test: `npm test -- --grep "test name"` ## Architecture - Monorepo with packages in `packages/` - API server in `packages/api/` (Express + TypeScript) - Frontend in `packages/web/` (React + Vite) - Shared types in `packages/shared/` ## Conventions - Use TypeScript strict mode - Prefer `as
- Overview
- File Placement
- Recommended Structure
- Content Guidelines
- What to Include
- What NOT to Include
- AGENTS.md vs Agent Skills
- Best Practices
What does the agents-md skill do?
Use when creating or updating AGENTS.md files to guide AI coding agents. Covers file structure, placement, content guidelines, and best practices for project-level agent instructions. USE FOR: project-specific agent instructions, build/test commands for agents, coding conventions, repository-level guidance DO NOT USE FOR: reusable cross-project skills (use agent-skills), agent runtime definition (use adl)
How do I install it?
Run `npx skills add majiayu000/claude-skill-registry --skill agents-md-tyler-r-kendrick-agent-skills --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.