write-skill — скилл для Claude Code: что делает и как установить
write-skill — скилл для Claude Code, который создаёт и правит текстовые файлы для агентов с проверкой поведения. Запускается при создании системных промптов, файлов CLAUDE.md и AGENTS.md, а также при повторных исправлениях ошибок агента.
MIT 1 000 установок ★ 10 обновлён 2026-10-16
npx skills add pwguler/skills --skill write-skill -a claude-codeЧто делает write-skill
Написание инструкций для агентов строится по принципу тестирования вперёд разработки. Сначала запускается базовый сценарий на агенте без целевого документа для фиксации сбоев. Затем создаётся минимальный текст, устраняющий эти сбои, после чего сценарий проверяется повторно.
Повторяющиеся исправления ошибок фиксируются в структуре документа на самом высоком уровне. Правило не применяется для разовых задач или случаев, когда логику проще реализовать через линтер или хук.
Перед использованием в Claude Code установите скилл командой npx skills add pwguler/skills --skill write-skill -a claude-code.
Какие задачи решает
- создать системный промпт для ИИ-агента
- проверить поведение агента до и после правки документа
- зафиксировать повторяющиеся ошибки в структуре инструкций
- написать минимальный текст для исправления сбоев агента
Примеры запросов агенту
- напиши правила для
AGENTS.md, используя write-skill - проверь поведение агента по сценарию с помощью write-skill
- исправь ошибку агента, зафиксировав урок в структуре
Как установить write-skill
1Через Skills CLI (Vercel)
npx skills add pwguler/skills --skill write-skill -a claude-code2Вручную: положить файлы
~/.claude/skills/write-skill/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/write-skill/
1Через Skills CLI (Vercel)
npx skills add pwguler/skills --skill write-skill -a codex2Вручную: положить файлы
.agents/skills/write-skill/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add pwguler/skills --skill write-skill -a cursor2Вручную: положить файлы
.cursor/skills/write-skill/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install pwguler/skills skills/write-skill2Вручную: положить файлы
.github/skills/write-skill/SKILL.md1Через Skills CLI (Vercel)
npx skills add pwguler/skills --skill write-skill -a gemini-cli2Командой платформы
gemini skills install https://github.com/pwguler/skills --path skills/write-skillВручную: положить файлы
.devin/skills/write-skill/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add pwguler/skills --skill write-skill -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о write-skill
Как установить write-skill в Claude Code?
Выполните команду npx skills add pwguler/skills --skill write-skill -a claude-code, а затем проверьте файл ~/.claude/skills/write-skill/SKILL.md.
Что делает write-skill?
Этот скилл помогает создавать и редактировать документы для агентов через проверку поведения в базовом и повторном сценариях.
Когда применяется скилл?
Скилл используется перед написанием CLAUDE.md, AGENTS.md или системных промптов, а также когда пользователь повторно исправляет ту же ошибку агента.
Исходный текст
SKILL.md · MIT
--- name: write-skill description: Create or edit a document that an agent reads, and prove that it changes behavior. Put a lesson that agents keep learning again into structure. Read this skill before you write or edit a skill, AGENTS.md, CLAUDE.md, a system prompt, or other text for agents. Use it to verify such a document before it ships. Use it also when the user corrects the same agent mistake a second time. --- Writing for agents is test-first development, applied to text. The same loop ships every document that an agent reads: skills, AGENTS.md, CLAUDE.md, and system prompts. 1. Run the baseline first. Run the scenario that the document targets on an agent WITHOUT the document. Record exactly how it fails, or what excuse it gives. Run the baseline in a fresh subagent that loads no skills and no context files, such as `AGENTS.md`. It keeps the base system prompt of your agent. When your agent cannot start such a subagent, use a new session without skills and context files. When you observe no failure, the document has nothing to teach. 2. Write the minimum text that fixes those specific failures. Do not write a manual. Write the shortest process that changes the behavior. 3. Run the scenario again with the document loaded. It passes, or the document is wrong. 4. Close loopholes. When a new run shows a new excuse, block it in the text, and verify again. Rules: - An eval script changes the mechanics, not the loop. When one exists, it runs the baseline and the second run. - A correction that the user makes a second time is a lesson that did not hold. Read [encode lessons in structure](references/encode-lessons-in-structure.md). Fix its class at the highest level that holds: a mechanism before any text. Only what no mechanism can hold goes through steps 1 to 4. - When the document is a skill in this repo, follow the [conventions for skills in this repo](references/conventions.md). - Skip this skill for work done once, or when standard practice is already well documented. Skip it also when a linter or hook could enforce the rule. In that case, build the linter or hook instead, as [encode lessons in structure](references/encode-lessons-in-structure.md) says.
© pwguler · MIT · pwguler/skills