AGENTS.md и CLAUDE.md для проекта

Делает короткий AGENTS.md до 60 строк: команды, соглашения и ссылки на документы репозитория, с проверкой путей, а CLAUDE.md превращает в ссылку на него. Для случаев, когда агенту нужны инструкции по проекту или старый файл разросся и устарел.

ДокументацияПак: Скиллы Sentry95 строкagents-md
Автор
Источник
getsentry/skills/skills/agents-md @ a582c51
Лицензия
Apache-2.0 · Copyright 2025 Functional Software, Inc. dba Sentry

Об этом скилле

Что делает

Скилл пишет или сокращает файл инструкций, который агент читает в репозитории первым: меньше 60 строк и ни при каких условиях не больше 100. Прежде чем писать, агент читает lock-файлы, package.json, Makefile, CI, README.md, CONTRIBUTING.md, SECURITY.md и docs/. Потом проверяет, что каждый записанный путь и каждая команда существуют.

Получаются в основном таблицы и списки: менеджер пакетов, команды тестов и линтера для отдельного файла, таблица со ссылками на документы про установку, архитектуру, API, безопасность и релизы. Ещё туда попадают несколько неочевидных соглашений и раздел об атрибуции со строкой Co-Authored-By для коммитов от ИИ. На существующие документы файл ссылается, а не пересказывает их; правила линтера, список скиллов и общие слова о качестве в него не попадают. Вложенный AGENTS.md появляется только там, где у поддерева свои команды, и действует ближайший файл. CLAUDE.md становится символической ссылкой на AGENTS.md, а не второй копией.

SPEC.md и SOURCES.md в папке — заметки для тех, кто сопровождает сам скилл: границы, способ проверки и источники (руководство по формату agents.md, документация OpenAI про AGENTS.md в Codex, спецификация Agent Skills). Агенту в работе они не нужны.

Когда включать и когда не надо

Когда в репозитории нет AGENTS.md или CLAUDE.md, когда существующий файл разросся в страницы прозы или команды и пути в нём устарели.

README, описания PR и скиллы его спецификация прямо исключает. Если атрибуция ИИ в коммитах вам не нужна или CLAUDE.md и AGENTS.md у вас намеренно разные, скажите агенту заранее.

Как поставить и вызвать

Команда установки ниже скачивает всю папку. Агент сам подхватывает скилл по описанию, когда вы просите AGENTS.md или CLAUDE.md. Вызвать вручную:

  • Claude Code: /agents-md или попросить скилл по имени.
  • Codex: $agents-md.
  • Cursor: наберите / в чате Agent и выберите agents-md.

Пример: /agents-md Наш CLAUDE.md разросся до 300 строк. Перепиши его в AGENTS.md короче 60 строк, а CLAUDE.md сделай ссылкой.

Чем отличается от похожих

Тексты для агентов: скиллы и AGENTS.md учит формулировать всё, что читает агент, и шаблона не даёт; этот скилл выпускает один файл заданной формы с лимитом строк. В Настройке контекста агента тоже есть шаблон CLAUDE.md, но сам скилл в основном о том, что загружать в сессию. Написание README пишет для людей, которые приходят в проект, а Скиллы по спецификации Agent Skills из того же набора занимается скиллами.

Установка

Выполните одну команду — она сохранит SKILL.md и файлы, которые он использует, в папку скиллов агента. Claude Code и Codex подхватывают новый скилл без перезапуска; если скилл не появился, перезапустите агента.

Скилл написан на английском — агент поймёт его и ответит вам по-русски.

Claude Code — macOS, Linux
curl -fsSL --create-dirs -o ~/.claude/skills/agents-md/SKILL.md https://anymodel.org/en/skills/sentry/agents-md/SKILL.md -o ~/.claude/skills/agents-md/LICENSE https://anymodel.org/en/skills/sentry/agents-md/LICENSE -o ~/.claude/skills/agents-md/SOURCES.md https://anymodel.org/en/skills/sentry/agents-md/SOURCES.md -o ~/.claude/skills/agents-md/SPEC.md https://anymodel.org/en/skills/sentry/agents-md/SPEC.md
Codex, Cursor — macOS, Linux
curl -fsSL --create-dirs -o ~/.agents/skills/agents-md/SKILL.md https://anymodel.org/en/skills/sentry/agents-md/SKILL.md -o ~/.agents/skills/agents-md/LICENSE https://anymodel.org/en/skills/sentry/agents-md/LICENSE -o ~/.agents/skills/agents-md/SOURCES.md https://anymodel.org/en/skills/sentry/agents-md/SOURCES.md -o ~/.agents/skills/agents-md/SPEC.md https://anymodel.org/en/skills/sentry/agents-md/SPEC.md
Claude Code — Windows PowerShell
foreach ($f in 'SKILL.md','LICENSE','SOURCES.md','SPEC.md') { $p = Join-Path "$HOME\.claude\skills\agents-md" $f; New-Item -ItemType Directory -Force (Split-Path $p) | Out-Null; Invoke-WebRequest "https://anymodel.org/en/skills/sentry/agents-md/$f" -UseBasicParsing -OutFile $p }
Codex, Cursor — Windows PowerShell
foreach ($f in 'SKILL.md','LICENSE','SOURCES.md','SPEC.md') { $p = Join-Path "$HOME\.agents\skills\agents-md" $f; New-Item -ItemType Directory -Force (Split-Path $p) | Out-Null; Invoke-WebRequest "https://anymodel.org/en/skills/sentry/agents-md/$f" -UseBasicParsing -OutFile $p }

Другой агент: сохраните файл в его папку скиллов или дайте ему ссылку на файл: https://anymodel.org/en/skills/sentry/agents-md/SKILL.md

SKILL.md

Исходник

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

Подключить через AnyModel API

Скилл работает на той модели, которую использует агент. Подключите Claude Code, Codex или Cursor к AnyModel и запускайте его на Claude, GPT, Gemini и других моделях по одному ключу — оплата за токены, без подписки.

Ещё из пака Скиллы Sentry

Аудит настроек Claude Code

Делает список разрешений для settings.json в Claude Code: по стеку репозитория подбирает только читающие команды нужных инструментов, домены документации и MCP Sentry или Linear. Для случаев, когда настраиваете или проверяете разрешения Claude Code.

Код-ревью по практикам Sentry

Делает ревью изменения по правилам Sentry: ошибки выполнения, производительность и N+1, побочные эффекты, совместимость, безопасность, архитектура и тесты, с вежливым тоном и одобрением при мелочах. Для случаев, когда нужно отревьюить PR или ветку.

Упрощение и выравнивание кода

Делает недавно изменённый код проще, не меняя поведения: меньше вложенности, без вложенных тернарников, понятные имена, без лишних абстракций, по соглашениям из CLAUDE.md. Для случаев, когда код работает, но читается тяжелее, чем нужно.

Коммиты в формате Conventional Commits

Делает коммиты в стиле Sentry по Conventional Commits: ветка вместо main, тема с типом до 70 символов с заглавной буквы, подвал Fixes или Refs, без персональных данных. Для случаев, когда нужно закоммитить или составить сообщение коммита.

Ревью доступа в Django

Делает ревью контроля доступа в Django и DRF: разбирает модель авторизации, прослеживает каждый эндпоинт от ID до запроса и сообщает только подтверждённые дыры с исправлением в коде. Для случаев, когда проверяете IDOR, права или изоляцию тенантов.

Поиск багов в изменениях ветки

Проверяет коммиты текущей ветки на дыры в безопасности, баги и проблемы качества по чек-листу из одиннадцати пунктов и выдаёт подтверждённые находки с файлом, строкой, уровнем и исправлением, не трогая код. Для случаев, когда нужен проход перед PR.

Ревью безопасности GitHub Actions

Ищет в воркфлоу GitHub Actions атаки, доступные постороннему без прав на запись: pwn request, инъекции через выражения, команды из комментариев, кражу токенов, подмену конфигов агентов. Для случаев, когда проверяют безопасность CI или меняют воркфлоу.

Доводка PR до зелёного CI

Доводит открытый PR до зелёного: чинит упавший CI и важные замечания ревью, проверяет локально, коммитит, пушит и повторяет, а на одобрении человека или черновике останавливается. Для случаев, когда PR красный или ждёт разбора комментариев.

Заголовок и описание PR

Пишет или обновляет заголовок PR в формате Sentry и короткое описание для ревьюеров без шаблонных разделов и логов тестов, затем открывает черновик или правит PR. Для случаев, когда открывают PR или новые коммиты поменяли его объём.

Оптимизация промптов

Пишет, чинит или переносит системные промпты и промпты агентов по небольшому набору тестов: сравнивает варианты на одних случаях и проверяет лучший на отложенных. Для случаев, когда промпт ненадёжен, переезжает на другую модель или ему нужны тесты.

Утечки секретов через сериализацию

Находит секреты, которые утекают, когда секретное поле в dataclass, модели pydantic или объекте JS встречает код, пишущий объекты целиком в логи или спаны; вторую половину ищет по всему репозиторию. Для случаев, когда изменение добавляет такое поле или код.

SECURITY_MODEL.md для инструментов ревью

Делает SECURITY_MODEL.md: описывает для инструментов ревью безопасности доступность системы, инварианты, классы находок и подтверждённые владельцем исключения. Для случаев, когда репозиторий готовят к автоматическому ревью безопасности.

Проверка скиллов на угрозы

Проверяет скилл до установки: статический скан на промпт-инъекции, скрытые символы, секреты, опасные скрипты и ловушки в структуре, затем разбор намерений и прав с вердиктом. Для случаев, когда скилл взят из чужого источника.

Скиллы по спецификации Agent Skills

Пишет и дорабатывает скиллы по процессу Sentry: источники с происхождением, самая простая форма исполнения, SPEC.md и SOURCES.md, проверка точности после правок и структурный валидатор. Для случаев, когда скилл будет поддерживать команда.

Ревью безопасности от Sentry

Ищет в файле, диффе или компоненте эксплуатируемые уязвимости по справочникам OWASP, изучает кодовую базу до вывода и сообщает только о находках с входом от атакующего. Для случаев, когда нужно ревью безопасности без шума.

Ревью производительности Django

Ищет в коде на Django и DRF N+1-запросы, неограниченные querysets, недостающие индексы и запись в цикле, проверяя объём таблиц и горячие пути. Для случаев, когда тормозит view или эндпоинт либо правка касается больших таблиц.