What is skills AGENTS.md?

Repository instructions for creating and maintaining coding-agent skills, including their files, registration, and naming rules.

Use them when creating or updating a skill, adding it to documentation and settings, or checking that the skill is registered correctly.

They give agents a consistent process for adding skills and help prevent missing registrations, duplicate aliases, or incorrect repository structure.

skills AGENTS.md — Instructions file by getsentry

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods

npx agentmods add instructions/getsentry/skills/agents-md

Clone the repo

git clone --depth 1 https://github.com/getsentry/skills

Made for: Codex, OpenCode.

Per session 479 This file is loaded in full into every session.

When invoked 479 The same file — it is already loaded in full.

Security scan A 0 findings. Scan, not verified.

Origin original No closer match found in the catalogue.

Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

Model	Per session	Once invoked
Fable 5	$0.00479	$0.00479
Opus 5	$0.00239	$0.00239
Sonnet 5	$0.00096	$0.00096
Haiku 4.5	$0.00048	$0.00048

Measured 2d ago against content hash e783846268d6, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

skills AGENTS.md scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

AGENTS.md · 39 lines

What it actually says

Agent Instructions

Skill Structure

skills/<skill-name>/SKILL.md
skills/<skill-name>/SPEC.md

If you use Claude marketplace sparse checkouts for this repo, include skills and agents alongside .claude-plugin because the root plugin manifest loads repo-root skills/ and agents/.

Creating/Updating Skills

ALWAYS use /skill-writer — it handles requirements, writing, registration, and validation.

Do not create per-skill alias or symlink skills
The repo-level .agents/skills path is a convenience mirror of canonical skills/
List only canonical skills in public skill inventories (for example pr-writer, skill-writer)

Registration Checklist

Create skills/<skill-name>/SKILL.md
Create skills/<skill-name>/SPEC.md
Add to README.md Available Skills table (alphabetical by canonical skill name; exclude aliases/symlinks)
Add to .claude/settings.json: Skill(sentry-skills:<skill-name>)
Add to allowlist in skills/claude-settings-audit/SKILL.md
For skills with deliberate invocation policy, set Claude's disable-model-invocation in SKILL.md and Codex's policy.allow_implicit_invocation in agents/openai.yaml to matching behavior

Key Conventions

Frontmatter --- must be the first line of SKILL.md — no comments before it
name field must match the directory name exactly
description includes trigger keywords — this is how agents discover the skill
Attribution comments go after the closing ---
Python scripts: always use uv run <script>, never python or python3
Keep SKILL.md under 500 lines; move reference material to references/
Keep runtime instructions in SKILL.md; put intent, source/evidence model, evaluation, limitations, and maintenance rules in SPEC.md

References

Skill template and optional fields: README.md
Testing and PR workflow: CONTRIBUTING.md
Agent Skills Spec

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

2d ago First seen · 39 lines · 479 tokens per session scan A e783846268d6

Subscribe to this mod's changes

skills AGENTS.md is an instructions file published in the GitHub repository getsentry/skills (973 stars, last pushed 7d ago), licensed Apache-2.0. It adds 479 tokens to every session, about $0.0024 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

tag-production

skills AGENTS.md

Getting it into your agent

What it costs to keep this loaded

Grade A, and why

Nothing flagged

What it actually says

Agent Instructions

Skill Structure

Creating/Updating Skills

Registration Checklist

Key Conventions

References

What this file has done since we first saw it

Other instructions, from other repositories

sentry-for-ai AGENTS.md

dotagents AGENTS.md

warden-skills AGENTS.md

sentry-mcp AGENTS.md

warden AGENTS.md

sentry-mcp CLAUDE.md