writing-agents-md — скилл для Claude Code
Скилл writing-agents-md помогает писать и аудировать файлы AGENTS.md и CLAUDE.md — инструкции для агентов, которые содержат решения, неочевидные для кода и инструментов.
лицензия не указана 305 установок ★ 655 обновлён 2026-10-20
npx skills add pedronauck/skills --skill writing-agents-md -a claude-codeЧто делает writing-agents-md
Скилл учит агента различать, что нужно в инструкциях агента, а что нет. Основная идея — сосредоточиться на нетривиальном: нестандартные команды, дорогие ограничения, терминология домена, решения о совместимости. Пересекающиеся или устаревшие правила лучше удалить, пересчитать или переместить в узкие скилы.
Внутри — методика в пять шагов: прочитать инструкции и репо, рассмотреть правила (оставить, переписать, переместить, удалить), разрешить противоречия, отредактировать файл, проверить, что важные инварианты и команды остались доступны. Скилл ориентирует агента на размер контекста, который попадёт в каждую задачу, а не на подсчёт строк. Итоговый отчёт должен назвать, что изменилось и какие ограничения остались.
Какие задачи решает
- Убрать устаревшие правила из инструкций агента
- Проверить, что команды в AGENTS.md не противоречат друг другу
- Переместить длинные объяснения в отдельные скилы или ссылки
- Оставить только то, что агент не может вывести из кода
- Сократить размер контекста инструкций для типовых задач
Примеры запросов агенту
- Проаудируй AGENTS.md в этом проекте: удали устаревшие правила и перемести конфликты в скилы
- Напиши CLAUDE.md для проекта на основе текущих правил в README и комментариях в коде
- Проверь, что все команды в .agents/skills согласованы с AGENTS.md
Как установить writing-agents-md
1Через Skills CLI (Vercel)
npx skills add pedronauck/skills --skill writing-agents-md -a claude-code2Вручную: положить файлы
~/.claude/skills/writing-agents-md/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/writing-agents-md/
1Через Skills CLI (Vercel)
npx skills add pedronauck/skills --skill writing-agents-md -a codex2Вручную: положить файлы
.agents/skills/writing-agents-md/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add pedronauck/skills --skill writing-agents-md -a cursor2Вручную: положить файлы
.cursor/skills/writing-agents-md/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install pedronauck/skills skills/mine/writing-agents-md2Вручную: положить файлы
.github/skills/writing-agents-md/SKILL.md1Через Skills CLI (Vercel)
npx skills add pedronauck/skills --skill writing-agents-md -a gemini-cli2Командой платформы
gemini skills install https://github.com/pedronauck/skills --path skills/mine/writing-agents-mdВручную: положить файлы
.devin/skills/writing-agents-md/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add pedronauck/skills --skill writing-agents-md -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о writing-agents-md
Как установить writing-agents-md в Claude Code?
Выполни npx skills add pedronauck/skills --skill writing-agents-md -a claude-code, затем скилл будет в ~/.claude/skills/writing-agents-md/SKILL.md.
Что делает writing-agents-md?
Скилл помогает написать и проверить файлы инструкций для агентов (AGENTS.md, CLAUDE.md). Учит отличать важные правила от дублей и устаревших, удалять лишнее и перемещать длинное в узкие скилы.
Чем writing-agents-md отличается от обычного редактирования инструкций?
Скилл даёт систему: проверить, что правило действительно нужно и только в этом месте, разрешить противоречия, учесть размер контекста для разных задач. Обычное редактирование может оставить дублирующиеся или устаревшие правила.