Skip to content
Skills Library
AI & agents · Building & coding

agents-md-protocol

/agents-md-protocol

Create or review an AGENTS.md file so coding agents get stable repo-local instructions: environment setup, testing, style, security boundaries, PR policy, and handoff rules. Use when a repo lacks durable agent guidance or when a custom harness needs a predictable context file.

Repository
ctx ↗
Licence
MIT
Last repository change
21.08.2026

Assessment and security

90/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content25 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
1
Scripts
0
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 21.08.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What it does and when to use it

Create or review an AGENTS.md file so coding agents get stable repo-local instructions: environment setup, testing, style, security boundaries, PR policy, and handoff rules. Use when a repo lacks durable agent guidance or when a custom harness needs a predictable context file.

Original author description

Create or review an AGENTS.md file so coding agents get stable repo-local instructions: environment setup, testing, style, security boundaries, PR policy, and handoff rules. Use when a repo lacks durable agent guidance or when a custom harness needs a predictable context file.

How it works

  1. Purpose
  2. When to Use
  3. Procedure
  4. Recommended Sections
  5. Quality Bar
  6. Harness Attachment
Original SKILL.md headings · 47 lines, 221 words
SKILL.md preview
---
name: agents-md-protocol
description: >
  Create or review an AGENTS.md file so coding agents get stable repo-local
  instructions: environment setup, testing, style, security boundaries, PR
  policy, and handoff rules. Use when a repo lacks durable agent guidance or
  when a custom harness needs a predictable context file.
---

# 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 text.
- Instructions match current CI and package metadata.

## Harness Attachment

For non-Claude-Code harnesses, load `AGENTS.md` as outer-loop project context.
The harness should also keep explicit task state outside conversation history.

Versions

The database has no other skills named agents-md-protocol.

Database snapshot: 13.11.2026 · package version 45bda7286ab7 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100init
    This skill should be used when a user asks to initialize a repository for AI agents, create or update an AGENTS.md file, scaffold agent instructions for a codebase, or improve existing agent guidance. Triggers include phrases like 'create an AGENTS.md', 'set up agent…
  • 100agents-md
    Write effective AGENTS.md files that give coding agents only the context they cannot infer from the repository. Use when creating a new AGENTS.md, improving or trimming an existing one, setting up a repo for AI coding agents, or onboarding agents to a codebase. Triggers on:…
  • 100agents-md
    Write effective AGENTS.md files that give coding agents the context they need to work in a repository. Use when creating a new AGENTS.md, improving an existing one, setting up a repo for AI coding agents, or onboarding agents to a codebase. Triggers on: "write AGENTS.md",…
  • 100project-context-setup
    Scaffolds per-repository agent context so coding agents share the same issue tracker rules, triage label vocabulary, domain glossary, ADR layout, and handoff conventions. Triggers on: "set up project context", "configure agent docs", "create CONTEXT.md", "setup agent workflow",…
  • 100agents-md
    This skill should be used when the user asks to "create AGENTS.md", "update AGENTS.md", "maintain agent docs", "set up CLAUDE.md", or needs to keep agent instructions concise. Guides discovery of local skills and enforces minimal documentation style.
  • 100create-agents-md
    Use when the user asks to create AGENTS.md, generate agent instructions for a repository, set up CLAUDE.md, or wants to document project conventions for coding agents. Also use when user says "create agents md", "setup agent docs", or "initialize repo for agents".

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.