thinking-circle-of-competence — скилл для Claude Code: не выдумывать
Заставляет агента отвечать только на том, что он реально прочитал или запустил в сессии. Помогает, когда цена уверенной ошибки высока.
npx skills add tjboudreaux/cc-thinking-skills --skill thinking-circle-of-competence -a claude-codeЧто делает thinking-circle-of-competence
Скилл разбирает утверждение на зоны: подтверждённое источником в текущей сессии, частичное и неподтверждённое. Дальше агент либо отвечает, либо идёт за фактом, либо честно отказывается. Выдуманное значение API, версии или пути он не подставляет.
Внутри — процедура из шести шагов и шаблон вывода. Сначала формулируется само утверждение, потом оценивается цена ошибки. Если речь о безопасности, потере данных или необратимой операции, частичное знание приравнивается к неподтверждённому, пока не проверено. Отдельный пункт запрещает переносить уверенность с соседнего кода или прошлых версий на нечитанный файл.
Работает это как правило поведения, а не как отдельная программа. Вызов модели у скилла отключён, поэтому он не запускается сам по себе. Полезно там, где агент любит достроить узор до полной картины: конфиги, номера версий, поведение библиотек. Проверка простая — если конкретное значение названо без источника и без пометки о неуверенности, скилл не сработал.
Какие задачи решает
- отличить подтверждённый факт о кодовой базе от правдоподобной догадки
- не выдумать номер версии или путь к конфигу
- остановить агента перед необратимой операцией без проверки
- пометить частичное знание вместо плоского утверждения
- заставить сначала прочитать файл, а потом отвечать
Примеры запросов агенту
- Проверь по этому скиллу, откуда ты знаешь название параметра в
config.yaml - Прежде чем менять схему, скажи, что здесь подтверждено сессией, а что догадка
- Ответь с пометкой о неуверенности и укажи, какой файл надо прочитать
Как установить thinking-circle-of-competence
1Через Skills CLI (Vercel)
npx skills add tjboudreaux/cc-thinking-skills --skill thinking-circle-of-competence -a claude-code2Вручную: положить файлы
~/.claude/skills/thinking-circle-of-competence/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/thinking-circle-of-competence/
1Через Skills CLI (Vercel)
npx skills add tjboudreaux/cc-thinking-skills --skill thinking-circle-of-competence -a codex2Вручную: положить файлы
.agents/skills/thinking-circle-of-competence/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add tjboudreaux/cc-thinking-skills --skill thinking-circle-of-competence -a cursor2Вручную: положить файлы
.cursor/skills/thinking-circle-of-competence/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install tjboudreaux/cc-thinking-skills thinking-circle-of-competence2Вручную: положить файлы
.github/skills/thinking-circle-of-competence/SKILL.md1Через Skills CLI (Vercel)
npx skills add tjboudreaux/cc-thinking-skills --skill thinking-circle-of-competence -a gemini-cli2Командой платформы
gemini skills install https://github.com/tjboudreaux/cc-thinking-skills --path skills/thinking-circle-of-competenceВручную: положить файлы
.devin/skills/thinking-circle-of-competence/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add tjboudreaux/cc-thinking-skills --skill thinking-circle-of-competence -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о thinking-circle-of-competence
Как установить thinking-circle-of-competence в Claude?
Выполните npx skills add tjboudreaux/cc-thinking-skills --skill thinking-circle-of-competence -a claude-code. Скилл окажется в ~/.claude/skills/thinking-circle-of-competence/SKILL.md.
Что делает thinking-circle-of-competence?
Проверяет, есть ли у утверждения источник в текущей сессии. Если нет — агент идёт за фактом, помечает неуверенность или отказывается отвечать.
Когда скилл не нужен?
Если факт вы прочитали или запустили в этой сессии, отвечать можно без оговорок. Также он не мешает помеченному брейншторму и гипотезам.
Исходный текст
SKILL.md · MIT
--- name: thinking-circle-of-competence description: Use when a specific claim may lack grounding. Check evidence boundary, size wrongness cost, then answer, fetch, or abstain — never confabulate. disable-model-invocation: true --- # Circle of Competence Treat competence as an evidence boundary, not self-image. Answer only when grounded; otherwise fetch, mark uncertainty, or abstain. The failure mode is a fluent fabrication treated as fact. ## When to Use - About to assert a specific fact (API, path, number, config, version behavior) without a citable source from this session. - The claim is about this codebase or system and you have not read or run the relevant artifact. - Pattern reconstruction would sound complete but is unconfirmed. - Cost of a wrong confident answer is material (security, data, irreversible action, trust). ## When NOT to Use - Claim is grounded in something you read, ran, or can cite this session, or is stable universal knowledge — answer without false humility. - Error cost is trivial and reversible and you will flag the claim as unverified. - Grounding is one cheap fetch away — fetch first; abstention is not an excuse to skip a check. - User explicitly wants labeled brainstorming or hypotheticals. ## Procedure 1. **Name the claim.** Isolate the assertion that would be treated as fact. 2. **Classify the zone.** - *Grounded:* citeable session source (read/run) or stable non-version-specific knowledge. - *Partial:* general shape known; version/repo/config detail unconfirmed. - *Ungrounded:* would invent a concrete value with no source. 3. **Size wrongness cost.** If high-stakes (security, data loss, irreversible ops), treat Partial as Ungrounded until verified. 4. **Act by zone.** - Grounded → answer; cite when useful; do not hedge verified facts. - Partial → cheap fetch then answer; else answer only with explicit uncertainty and a check path. - Ungrounded → fetch if possible; else ask or abstain with what would enable an answer. Never invent. 5. **Refuse competence creep.** Adjacent code, prior versions, or general capability do not ground the unread target. 6. **Stop.** Emit answer, fetch request, or abstention. Do not round "probably" to a flat assertion. **Stop condition:** Claim answered with grounding, marked partial with a check path, or refused with missing-evidence note. ## Output ```text Claim: <assertion> Zone: grounded | partial | ungrounded Evidence: <source or none> Wrongness cost: low | medium | high Action: answer | fetch-then-answer | answer-with-uncertainty | abstain/ask Response: <wording or missing artifact> ``` ## Verification - Falsify if a specific value was asserted with no session source and no uncertainty marker. - Falsify if Partial/high-stakes was treated as Grounded, or a cheap fetch was skipped for abstention theater. - Over-application guard: do not hedge or refuse claims verified this session.
© tjboudreaux · MIT · tjboudreaux/cc-thinking-skills