agents-md-protocol
Create or review an AGENTS.md file so coding agents get stable repo-local policy, and handoff rules. Use when a repo lacks durable agent guidance or when a custom harness needs a predictable context file.
npx skills add stevesolun/ctx --skill agents-md-protocol --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 Protocol ## Purpose Create or tighten a repository-level `AGENTS.md` contract for coding agents. Treat it as durable operating context, not a chat prompt. ## When to Use - Repo has no `AGENTS.md`, `CLAUDE.md`, or equivalent agent instructions. - Existing instructions are stale, vague, or missing test commands. - A custom/API/local harness needs stable context it can load every run. - A multi-agent workflow needs explicit handoff and review rules. ## Procedure 1. Inspect repo layout, package managers, CI files, and test commands. 2. Capture only durable facts and team rules. 3. Keep commands exact and runnable from the documented directory. 4. Add security and destructive-operation boundaries. 5. Add PR/review expectations and required verification. 6. Keep the file short enough to load every session. ## Recommended Sections - `Dev environment tips` - `Testing instructions` - `Build and lint` - `Code style` - `Security boundaries` - `PR instructions` - `Agent handoff notes` ## Quality Bar - Every command has a working directory or clear scope. - No secrets, tokens, or private URLs. - No vague rules such as "be careful" without a concrete check. - No roadmap or marketing
- Purpose
- When to Use
- Procedure
- Recommended Sections
- Quality Bar
- Harness Attachment
What does the agents-md-protocol skill do?
Create or review an AGENTS.md file so coding agents get stable repo-local policy, and handoff rules. Use when a repo lacks durable agent guidance or when a custom harness needs a predictable context file.
How do I install it?
Run `npx skills add stevesolun/ctx --skill agents-md-protocol --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 stevesolun/ctx, a repository with 569 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.