skill CX Codex

agents-md · callicrate — Claude Code skill: what it does, how to install

Q: How do I install agents-md in Claude Code?

Run `npx skills add Callicrate/skills --skill agents-md -a claude-code` in your terminal. The skill file is placed in `~/.claude/skills/agents-md/SKILL.md`.

Drafts, audits, and maintains repository-level AGENTS.md files. Keeps coding agents focused on live project conventions and verified commands.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓

npx skills add Callicrate/skills --skill agents-md -a claude-code

Open on GitHub

What agents-md does

This skill builds scoped behavioral rules for automated assistants directly from repository evidence. It collects active file paths, local execution commands, and common pitfalls, filtering out high-level doc material.

It offers several distinct modes. You can fix minor path drifts with patch, draft fresh guidance via create, split monorepo files across subdirectories, or run review to inspect rules without writing changes. Bundled helper scripts like analyze_project.py and validate_agentsmd.py handle stack inspection and command checks.

Without a local Python runtime, the built-in validation and analysis scripts will not run. The skill deliberately limits itself to AGENTS.md boundaries, avoiding generic README updates or architecture documents.

What it helps with

draft a clean AGENTS.md baseline for an unconfigured repository
audit existing agent instructions for broken links and invalid commands
partition monorepo rules into directory-scoped instruction files
patch specific instruction sections without modifying valid entries

Example prompts for the agent

Create a minimal AGENTS.md file tailored to our repository structure
Review the current AGENTS.md and highlight broken commands by risk level
Update AGENTS.md after moving our test suites to a new directory

How to install agents-md

1Skills CLI (Vercel)

npx skills add Callicrate/skills --skill agents-md -a claude-code

2Manually: put the files in place

~/.claude/skills/agents-md/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/agents-md/

1Skills CLI (Vercel)

npx skills add Callicrate/skills --skill agents-md -a codex

2Manually: put the files in place

.agents/skills/agents-md/SKILL.md

For all projects use ~/.agents/skills/

1Skills CLI (Vercel)

npx skills add Callicrate/skills --skill agents-md -a cursor

2Manually: put the files in place

.cursor/skills/agents-md/SKILL.md

Cursor also reads .agents/skills/ and .claude/skills/

1GitHub CLI

gh skill install Callicrate/skills agents-md

2Manually: put the files in place

.github/skills/agents-md/SKILL.md

1Skills CLI (Vercel)

npx skills add Callicrate/skills --skill agents-md -a gemini-cli

2Platform CLI

gemini skills install https://github.com/Callicrate/skills --path agents-md

Manually: put the files in place

.devin/skills/agents-md/SKILL.md

The legacy .windsurf/skills/ path still works

Skills CLI (Vercel)

npx skills add Callicrate/skills --skill agents-md -a opencode

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about agents-md

How do I install agents-md in Claude Code?

Run npx skills add Callicrate/skills --skill agents-md -a claude-code in your terminal. The skill file is placed in ~/.claude/skills/agents-md/SKILL.md.

What does agents-md do?

It standardizes and verifies repository instructions for coding agents, validating paths and scripts against the real codebase.

What prerequisites are needed for validation?

You need Python installed locally to execute the internal structure verification and semantic checking tools.

agents-md by other authors comes first.

agents-md getsentry Generates and maintains concise AGENTS.md and CLAUDE.md instruction files for repositories. Keeps coding agent rules short, verified, and reference-backed. CX Codex +1 7,100installs agents-md mblode Cleans up agent instruction files: checks repository commands and moves the rules into one shared AGENTS.md. CX Codex +1 803installs setup-matt-pocock-skills Matt Pocock This skill configures a repository for Matt Pocock's engineering skills by setting its issue tracker, triage labels, and domain docs layout. Run it before using the other skills. 1,052,851installs ask-matt Matt Pocock Routes you to the right Matt Pocock skill or flow for the task at hand. Use it when you need a starting point for a feature, prototype, incoming issue, or hard bug. 766,587installs to-tickets Matt Pocock Turns a plan, spec, or conversation into small end-to-end tickets with explicit blockers. Use it to agree on the work breakdown before tickets go to a tracker. 711,230installs writing-plans Jesse Vincent This skill turns requirements for a multi-step task into an implementation plan before code changes begin. It helps when another engineer needs exact files, interfaces, and checks. CX Codex 282,859installs caveman-review JuliusBrussee Turns code review comments into one line per finding: location, problem, fix. Useful when a diff or PR needs a fast pass without the filler. CX Codex +1 411,800installs caveman-compress JuliusBrussee Compresses CLAUDE.md, todo lists, and other prose files into a shorter format while retaining a readable backup. CX Codex +1 411,500installs

From the same set2

make-documentation This skill writes READMEs, architecture notes, changelogs, runbooks, and install docs. It helps choose a document workflow and review the result. CX Codex +1 1,500installs