readchk — скилл для Claude Code: проверка понимания задачи
Скилл проверяет, правильно ли агент понял вашу инструкцию, до того как потратит работу. Пригодится на длинных и необратимых задачах.
npx skills add LilMGenius/paperthin --skill readchk -a claude-codeЧто делает readchk
readchk ловит неверно прочитанную инструкцию раньше, чем по ней начнётся связная работа не по той цели. Агент пересказывает задание своими словами, сверяет пересказ с текущим сообщением, историей сессии, памятью проекта, файлами на диске и принятыми в проекте соглашениями. Если контекст снимает неоднозначность, работа идёт молча.
Скилл включается на длинных или составных запросах, на размытых местоимениях вроде «это», «то», «второй», «как удобнее», а ещё там, где ошибка стоит дорого. Пересказ должен быть парафразом: дословный повтор ничего не доказывает. Если после сверки остаётся настоящая развилка, агент задаёт один конкретный вопрос и называет выбор, а не спрашивает «так нормально?». Несколько неясностей разбираются по одной, начиная с самой рискованной.
Это не factchk: здесь проверяют, что имелось в виду, а не верно ли утверждение о мире. Для крупных задач агент пишет строку вида «understood as: ...» перед началом, чтобы позже можно было сверить сделанное с подтверждённым пониманием. Такие записи он оставляет для планов, правок в нескольких файлах и необратимых действий, а не для каждого шага. Молчаливый проход — нормальный результат, и вопрос по однозначному запросу считается дефектом.
Какие задачи решает
- поймать неверно понятую задачу до начала работы
- разобрать длинный запрос из нескольких частей
- выяснить, к чему относится местоимение в инструкции
- не переспрашивать там, где контекст уже всё объяснил
- оставить след о том, как поняли задание, для последующей проверки
Примеры запросов агенту
- Перепиши мою задачу своими словами и скажи, если что-то понял не так
- В запросе есть «сделай это почище» — уточни, что именно имеется в виду, прежде чем править код
- Перед правкой в нескольких файлах зафиксируй, как ты понял задачу
Как установить readchk
1Через Skills CLI (Vercel)
npx skills add LilMGenius/paperthin --skill readchk -a claude-code2Вручную: положить файлы
~/.claude/skills/readchk/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/readchk/
1Через Skills CLI (Vercel)
npx skills add LilMGenius/paperthin --skill readchk -a codex2Вручную: положить файлы
.agents/skills/readchk/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add LilMGenius/paperthin --skill readchk -a cursor2Вручную: положить файлы
.cursor/skills/readchk/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install LilMGenius/paperthin readchk2Вручную: положить файлы
.github/skills/readchk/SKILL.md1Через Skills CLI (Vercel)
npx skills add LilMGenius/paperthin --skill readchk -a gemini-cli2Командой платформы
gemini skills install https://github.com/LilMGenius/paperthin --path skills/depth/readchkВручную: положить файлы
.devin/skills/readchk/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add LilMGenius/paperthin --skill readchk -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о readchk
Как установить readchk в Claude?
Выполните npx skills add LilMGenius/paperthin --skill readchk -a claude-code. Скилл окажется в ~/.claude/skills/readchk/SKILL.md.
Что делает readchk?
Проверяет, верно ли агент понял вашу инструкцию, до того как потратит на неё работу. Пересказывает задание, сверяет с контекстом и задаёт вопрос только при настоящей развилке.
Чем readchk отличается от factchk?
readchk выясняет, что вы имели в виду. factchk проверяет, верно ли утверждение о мире. Это разные вопросы.
Исходный текст
SKILL.md · MIT
--- name: readchk description: "Verify the model's understanding of a user's instruction before spending non-trivial work. Use when a request is long, bundled, high-stakes, hard to undo, or has ambiguous scope or referents such as this, that, it, the other one, whatever is cleaner, or whichever order makes sense. Restate internally, cross-check against available context, proceed silently when resolved, and surface only a genuine surviving fork." --- Check the read before acting: did you understand the instruction correctly enough to spend the work? ## Goal `readchk` catches misread instructions before they become coherent work against the wrong target. It verifies a claim about the requester's intent against available context: the current message, session history, project memory, files on disk, and established conventions. This is not `factchk`: the question is what was meant, not whether a world claim is true. ## Workflow 1. Recognize the signal: a long or multi-part instruction, ambiguous scope or referents, deliberately flexible wording, or stakes high enough that a wrong guess would cost real work. 2. Restate the instruction internally in different words. Do not copy the user's wording back to yourself and treat that as understanding. 3. Cross-check the restatement against available context. Look for contradictions, missing antecedents, or two plausible readings that context cannot choose between. 4. If context resolves the read, proceed silently. Do not ask the requester to confirm what the available context already answered. 5. If a real fork survives, surface one specific clarifying question anchored to the restated understanding. Name the choice; do not ask a vague "does this look right?" 6. For substantial work, log one durable "understood as: ..." line before beginning so a later reader can audit whether the work matched the confirmed read. ## Rules - **Restate, don't echo.** A paraphrase proves you built a model of the request; a verbatim repeat proves little. - **Silent when context resolves it.** The default good outcome is invisible. Surfacing a question for a resolved or unambiguous request is a defect. - **One fork at a time.** If several ambiguities exist, surface the highest-stakes one first instead of dumping a checklist. - Never silently resolve a fork that changes the shape of the work. - **Log large commitments, not every turn.** Durable read logs are for plans, multi-file changes, irreversible actions, or work a fresh reviewer may need to audit. ## Verification Before proceeding with the work: the restatement is a paraphrase, every surfaced fork is genuinely unresolved by available context, and no substantial work starts without either a silent pass or a resolved fork.
© LilMGenius · MIT · LilMGenius/paperthin