Index of every page on this site: llms.txt
All skills
getsentry avatar

/agents-md

@a582c51 official
by Sentrygetsentry/skills1.2k stars
71
Run it yourself

Creates and maintains concise AGENTS.md and CLAUDE.md project instruction files. Use when asked to create AGENTS.md, update AGENTS.md, maintain agent docs, set up CLAUDE.md, document repository agent conventions, or keep coding-agent instructions minimal and reference-backed.

Use this Skill: https://skilld.dev/gh/getsentry/skills/agents-md

Nothing lands on disk. Nothing to clean up.

Fork this Skill

Edit a local copy. It keeps the author and licence.

SKILL.md

≈72 tokens for metadata: the name and description. ≈718 when used: this file. ≈2.1k more on demand in 2 files.

Description uses 3.6% of example budget

Before choosing a Skill, your Agent reads its name and description. All available Skills share that space.

  • A shorter description leaves more room for other Skills. This entry exceeds our 1% size suggestion.

In our Claude Code example, all Skill names and descriptions share 8,000 characters. This Skill uses ≈288 characters, or 3.6%.

The 1% threshold is a size suggestion. Longer descriptions can still fit.

Your model, settings, and other Skills decide how much text your Agent can read.

Example settings and source

The example uses a 200k-token context and default Claude Code settings. The count includes the name, description, separators, and when_to_use when present. Codex also counts local file paths.

Skit's source and limits: Codex 0.160.1, Claude Code 2.1.292.

Maintaining AGENTS.md

Goal: concise, actionable agent instructions. Target under 60 lines; never exceed 100.

Workflow

  1. Inspect before writing:
    • package manager: lock files and manifests
    • commands: package.json, Makefile, task runners, CI workflows
    • docs/specs/policies: README.md, CONTRIBUTING.md, docs/, specs/, policies/, SECURITY.md, .github/
    • conventions: current code patterns, test layout, generated files, legacy areas to avoid
  2. Choose scope:
    • root AGENTS.md: repo-wide defaults
    • nested AGENTS.md: only when a subtree has different commands or rules
    • closest instruction file wins; keep narrower files shorter than root files
  3. Write the smallest useful file.
  4. Verify exact paths and commands exist.

File Setup

  • Create AGENTS.md at the repository root.
  • If a Claude-compatible entrypoint is required, symlink CLAUDE.md to AGENTS.md.
  • Do not maintain divergent AGENTS.md and CLAUDE.md copies.

Default Sections

Use only sections that add non-obvious value.

# Agent Instructions

## Package Manager
- Use **pnpm**: `pnpm install`

## Commands
| Task | Command |
|------|---------|
| Test file | `pnpm vitest run path/to/file.test.ts` |
| Lint file | `pnpm eslint path/to/file.ts` |

## External References
| Need | File |
|------|------|
| Setup | `CONTRIBUTING.md` |
| Architecture | `docs/architecture.md` |
| Security policy | `SECURITY.md` |

## Key Conventions
- Generated files: update with `pnpm generate`; do not edit by hand.

## Commit Attribution
AI commits MUST include:
```
Co-Authored-By: (the agent's name and attribution byline)
```

Writing Rules

  • Use headings, bullets, and tables; avoid paragraphs.
  • Use repo-relative paths; avoid vague references like "see docs".
  • Reference existing docs/specs/policies instead of copying them.
  • List exact external files for setup, architecture, API specs, security, release, and policy docs when they exist.
  • Prefer file-scoped test/lint/typecheck commands; include full builds only when no narrower command exists.
  • Put commands in tables when there is more than one.
  • Keep one rule per bullet.
  • Keep rationale out unless it prevents a likely mistake.
  • Do not restate linter, formatter, or typechecker config.
  • Do not list installed skills or plugins.
  • Do not include generic quality slogans.

External Reference Rules

Good:

## External References
| Need | File |
|------|------|
| API contract | `docs/api.md` |
| Release process | `docs/releasing.md` |

Anti-Patterns

  • welcome text, intros, conclusions, or pleasantries
  • long prose explaining why instructions matter
  • duplicated content from README.md, CONTRIBUTING.md, or policy docs
  • project-wide commands when file-scoped commands are available
  • nested AGENTS.md files that repeat root instructions

Source: SKILL.md on GitHub

skilld matched fixed text patterns in SKILL.md and file names. Patterns miss obfuscated code.

skilld run checks every file with the same patterns. It asks for approval before it loads a Skill with a behavior marked Needs approval.

1 warning2mo5 checks · Risk SAFE
  • Gen Agent Trust Hub2mo

    The skill is a documentation tool designed to create and maintain concise agent instruction files (AGENTS.md and CLAUDE.md). It operates entirely as a structural guideline for text generation and contains no executable code or active scripts. A low-risk surface for indirect prompt injection exists because the skill instructs the agent to read existing repository documentation and configuration files to build its output.

  • Socket2mo

    No alerts

  • Snyk2mo

    Risk: LOW · No issues

  • Runlayer8mo

    1 file scanned · No issues

  • ZeroLeaks7mo

    1 finding · Score: 69/100

Signed by skilld at a582c51. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub 6 days ago.

Activeupdated 7 months ago
  • Documentation
  • agents
  • claude
  • project-setup
  • instructions
  • markdown
  • repository
  • coding-agents

README badge

README badge for getsentry/skills/agents-md

Creates and maintains concise AGENTS.md and CLAUDE.md instruction files for AI coding agents. Provides a workflow for inspecting package managers, commands, docs, and conventions, then generates minimal agent instructions under 60 lines with exact paths and commands verified against the repository.

Generated from the current SKILL.md.

What is the difference between AGENTS.md and CLAUDE.md?
CLAUDE.md is a Claude-compatible entrypoint that should be symlinked to AGENTS.md rather than maintained as a separate copy. The skill does not maintain divergent versions of these files.
Should I create nested AGENTS.md files in subdirectories?
Only when a subtree has different commands or rules than the root. Keep nested files shorter than the root file, and remember that the closest instruction file wins.
How long should AGENTS.md be?
Target under 60 lines; never exceed 100. The goal is concise, actionable instructions that reference external docs rather than duplicating them.
Should AGENTS.md include explanations of why instructions matter?
No. The skill avoids welcome text, intros, conclusions, and long prose. Include only rationale that prevents a likely mistake.
What should I reference in the External References section?
Link to existing files like CONTRIBUTING.md, docs/architecture.md, SECURITY.md, and API specs. Do not copy their content into AGENTS.md.

Generated from the current SKILL.md. These answers refresh after source changes.