AGENTS.md и CLAUDE.md для проекта
Делает короткий AGENTS.md до 60 строк: команды, соглашения и ссылки на документы репозитория, с проверкой путей, а CLAUDE.md превращает в ссылку на него. Для случаев, когда агенту нужны инструкции по проекту или старый файл разросся и устарел.
agents-md- Автор
- Sentry
- Источник
- 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 подхватывают новый скилл без перезапуска; если скилл не появился, перезапустите агента.
Скилл написан на английском — агент поймёт его и ответит вам по-русски.
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
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
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 }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
- 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
- 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
- root
- Write the smallest useful file.
- Verify exact paths and commands exist.
File Setup
- Create
AGENTS.mdat the repository root. - If a Claude-compatible entrypoint is required, symlink
CLAUDE.mdtoAGENTS.md. - Do not maintain divergent
AGENTS.mdandCLAUDE.mdcopies.
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.mdfiles that repeat root instructions
Подключить через AnyModel API
Скилл работает на той модели, которую использует агент. Подключите Claude Code, Codex или Cursor к AnyModel и запускайте его на Claude, GPT, Gemini и других моделях по одному ключу — оплата за токены, без подписки.
AnyModel