credible-claims — скилл для Claude Code: бриф до работы, запись
Скилл для делегированной и ИИ-ассистированной исследовательской работы: сначала бриф, потом запись утверждений. Помогает не путать быстрое выполнение с доказательством.
npx skills add pedrohcgs/claude-code-my-workflow --skill credible-claims -a claude-codeЧто делает credible-claims
Скилл вводит два артефакта. Исследовательский бриф пишется до запуска работы и задаёт вопрос, критерии завершения, запрещённые подмены, известные сбои, требуемые доказательства и триггеры эскалации. Запись утверждений идёт во время и после: для каждого утверждения указывается, какие данные его поддерживают, что менялось после того, как стали видны результаты, что осталось непроверенным и кто решил, что можно сообщать.
Внутри — три постоянных правила. Делегировать только после того, как ясны входы, границы и критерии завершения. Требовать проверяемые доказательства, а не уверенные выводы: локации, диффы, диагностику, счётчики, падающие случаи, логи. И возвращать пользователю всё, что меняет экономический объект, идентифицирующие допущения, процедуру вывода или язык отчётности. Маршрут, который зависит от недоступных данных или недоказанного результата, помечается как заблокированный.
Скилл не даёт решать, что «все проверки зелёные». Решение — поддерживают ли доказательства предложенную формулировку: починить, сузить язык, отправить на дополнительную проверку, пометить как exploratory или отказаться от отчёта. Доступные инструменты — Read, Grep, Glob, Write, поэтому скилл читает и пишет файлы, но не запускает код. Пропорциональность важна: рутинной задаче хватит одного абзаца, тяжёлая запись нужна при обширном ветвлении, повторном использовании результатов или дорогой цене ошибки.
Какие задачи решает
- написать бриф перед запуском длинной автономной задачи
- зафиксировать, какие данные поддерживают каждое утверждение
- отличить диагностическую правку от подгонки под результат
- пометить маршрут как заблокированный вместо поиска удобного ответа
- не дать формулировке в отчёте перерасти доказательства
Примеры запросов агенту
- Напиши research brief перед запуском этой задачи
- Собери claim record по результатам прогона
- Проверь, не апгрейдится ли язык отчёта выше доказательств
Как установить credible-claims
1Через Skills CLI (Vercel)
npx skills add pedrohcgs/claude-code-my-workflow --skill credible-claims -a claude-code2Вручную: положить файлы
~/.claude/skills/credible-claims/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/credible-claims/
1Через Skills CLI (Vercel)
npx skills add pedrohcgs/claude-code-my-workflow --skill credible-claims -a codex2Вручную: положить файлы
.agents/skills/credible-claims/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add pedrohcgs/claude-code-my-workflow --skill credible-claims -a cursor2Вручную: положить файлы
.cursor/skills/credible-claims/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install pedrohcgs/claude-code-my-workflow credible-claims2Вручную: положить файлы
.github/skills/credible-claims/SKILL.md1Через Skills CLI (Vercel)
npx skills add pedrohcgs/claude-code-my-workflow --skill credible-claims -a gemini-cli2Командой платформы
gemini skills install https://github.com/pedrohcgs/claude-code-my-workflow --path .claude/skills/credible-claimsВручную: положить файлы
.devin/skills/credible-claims/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add pedrohcgs/claude-code-my-workflow --skill credible-claims -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Из того же набора11
Похожие
Рядом в теме «Наука и исследования»
Всё по теме «Наука и исследования» →Вопросы о credible-claims
Как установить credible-claims в Claude?
Выполните npx skills add pedrohcgs/claude-code-my-workflow --skill credible-claims -a claude-code. Скилл окажется в ~/.claude/skills/credible-claims/SKILL.md.
Что делает credible-claims?
Вводит два артефакта: исследовательский бриф до запуска работы и запись утверждений при отчёте о результатах. Бриф ограничивает, что системе позволено делать, запись — что можно сообщать.
Какие инструменты доступны скиллу?
Read, Grep, Glob, Write. Он читает и пишет файлы, но не запускает код и не выполняет анализ сам.
Исходный текст
SKILL.md · MIT
--- name: credible-claims description: Research-brief + claim-record discipline for delegated or AI-assisted research work. Use when starting any substantive research task or long autonomous run (write the brief first), and when reporting results that will support a claim in a paper or decision (produce the claim record). Keeps faster execution from being confused with credible evidence. allowed-tools: ["Read", "Grep", "Glob", "Write"] metadata: protocol: bounded-delegation --- # Credible claims: the brief before, the record after Cheaper generation increases demand for scarce validation. The fix is two lightweight artifacts: a **research brief** that constrains what the system may do, and a **claim record** that constrains what may be reported. Applies to agents, workflows, sims, proof patches, data construction — anything delegated. ## Three standing rules 1. **Delegate only after inputs, boundaries, and completion criteria are clear.** No open-ended "make it better" runs. 2. **Require evidence, not confident conclusions.** Every delegated task returns inspectable evidence: locations, diffs, diagnostics, counts, failing cases, logs — never just "done/looks fine." 3. **Escalate anything that changes the economic object, the identifying assumptions, the inferential procedure, or the reporting language.** Those decisions return to the researcher (the user), always. A standing user ruling counts as a returned decision; record it. ## The research brief (before execution) One short block, written before launching the work: - **Question / target:** what exactly is being estimated, proved, built. - **Completion:** what counts as done; what results would *not* answer the question. - **Prohibited substitutions:** what the system may not silently change (estimand, sample, assumptions, statement of a theorem, benchmark spec). - **Known failure modes:** what tends to go wrong here; the checks matched to each. - **Required evidence:** what must come back (numbers, locations, diffs, diagnostics). - **Escalation triggers:** which findings/decisions must return to the user before proceeding. - **Blocked-route rule:** a route that depends on unavailable data, an unsupported assumption, or an unproved result is marked *blocked* — a scientific outcome, not an instruction to search until a favorable answer appears. ## The claim record (during/after execution) For each claim the work will support: - **Support:** which data/analysis/proof supports it (with locations). - **Changes after seeing results:** anything modified after outcomes were visible, and why (diagnostic-triggered fix vs favorable switch — keep these distinguishable). - **Unresolved:** checks that remain open, and how they constrain the language. - **Decision:** who decided what could be reported (user ruling vs assistant default). Proportionality: a routine task needs one short paragraph; heavier records only when branching is extensive, outputs will be reused, errors are consequential, or correction is costly. ## Reporting language The final decision is never "all checks green" — it is whether the evidence supports the proposed *language*. The options are: repair; **narrower language**; additional review; an *exploratory/descriptive* label; or decline to report. Never upgrade language beyond the evidence (associational ≠ causal; pointwise ≠ uniform; illustrated ≠ validated; imposed ≠ derived). ## Keep credibility questions separate Reproducibility, implementation correctness, statistical performance, measurement validity, and identification/scope are different questions; evidence on one cannot answer another. Reproducible code may implement the wrong estimator; favorable simulations cannot establish an assumption; a correct estimate may answer the wrong question. ## Learn forward Every diagnosed failure becomes a durable artifact: a reusable test, a documented warning, or a memory entry stating the failure, why it happened, and the check that now prevents it. Preserve failed approaches and the reason they failed — a blocked route re-attempted without a new mechanism is waste. ## Cross-references - [`verification-ladder.md`](../../references/verification-ladder.md) — rung 5 (the ledger) - [`.claude/rules/orchestrator-protocol.md`](../../rules/orchestrator-protocol.md) — RUN_CONFIG is the brief for a fan-out
© pedrohcgs · MIT · pedrohcgs/claude-code-my-workflow