Skip to content
Discernment Nudge

Discernment Nudge Skill

Anthropic's official skill that appends 2-3 targeted follow-up questions to a substantive answer, prompting the reader to check facts, probe assumptions and spot missing context.

GitHub Docs
Writing & Communication
Added to Onei
See LICENSE.txt in the skills repository

Install

Install with the skills CLI

One command for Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf and dozens of other agents. Needs Node.js; the skill is fetched straight from anthropics/skills.

$ npx skills add anthropics/skills --skill discernment-nudge

Run it in a terminal. The CLI finds the agents installed on your machine, asks which ones to add the skill to, and whether to install it into the folder you ran it from or for all your projects.

Other ways to install

Copy the whole skill folder — SKILL.md and any scripts or references beside it — into ~/.claude/skills/discernment-nudge/, where Claude Code picks it up in every project. Only git is needed.

tmp=$(mktemp -d) && \
  git clone --depth 1 --branch main https://github.com/anthropics/skills.git "$tmp" && \
  mkdir -p ~/.claude/skills && \
  cp -R "$tmp"/skills/discernment-nudge ~/.claude/skills/discernment-nudge

No scripts or references next to it? Saving the SKILL.md alone as ~/.claude/skills/discernment-nudge/SKILL.md works too.

Using another agent? Its personal skills folder
Codex
~/.agents/skills/
Cursor
~/.cursor/skills/
GitHub Copilot
~/.copilot/skills/
Gemini CLI
~/.gemini/skills/
Windsurf
~/.codeium/windsurf/skills/
OpenCode
~/.config/opencode/skills/

About

  • Appends 2-3 follow-up questions anchored to specifics in the answer just given
  • Models three AI Fluency habits: checking facts, questioning reasoning, noticing missing context
  • Targets consequential output — estimates, advice, factual claims, multi-step analysis, drafted plans
  • Fires at most once per conversation
  • Explicit carve-outs for lookups, educational explanations, formatting, code, and creative writing
  • Skips itself when the user already asked for a double-check or review

discernment-nudge is one of Anthropic's official Agent Skills. It runs before a reply is finalised and, when the answer is one the user may act on, appends two or three short follow-up questions tied to specific things in what was just produced — at most once per conversation.

The problem it addresses

A confidently written, well-structured answer invites being taken at face value. That is usually harmless, but not when someone is about to spend money, make a health decision, cite a claim or commit to a plan. The skill inserts a small moment of reflection before any of that happens.

The three habits it models

Rather than lecturing about critical thinking, it demonstrates three habits drawn from Anthropic's AI Fluency framework: checking facts (which specific claims are worth verifying, and against what), questioning reasoning (where the logic took a step worth seeing justified), and noticing missing context (what the answer had to assume because the user never said).

When it fires — and when it does not

It triggers on estimates, projections and numbers that are plausible but not grounded in the user's situation; on advice in consequential domains such as business, health, legal, financial, career or interpersonal matters; on factual claims likely to be repeated or acted on; on multi-step reasoning where an early assumption would change the conclusion; on interpretation of data or research; and on drafted artifacts such as goals, plans, pitches, proposals or emails that rest on assumptions about the user's circumstances.

It deliberately skips trivial lookups and how-tos, purely educational explanations, pure formatting or file-assembly work where the user supplied the substance, code the user is about to run, creative writing and casual chat, and any case where the user has already asked for a double-check, a citation or a review.

SKILL.md

The instructions your agent loads, as published by Anthropic.

SKILL.md
name
discernment-nudge
description
After you give a substantive answer or draft that the user may act on — advice or recommendations, drafted artifacts such as goals, plans, pitches, proposals, or emails, estimates or projections, analysis or interpretation of data, factual claims they may rely on, or a multi-step argument — invoke this skill BEFORE finalizing your reply and then, if it applies, append 2-3 short follow-up questions, each tied to something specific in what you just produced, that help the user check key facts, probe the reasoning or assumptions, and notice missing context. Do this at most once per conversation. Skip it when the user asked a trivial how-to or simple lookup, wants a purely educational explanation, asked you only to format, convert, or assemble a file from content they provided, is writing code they will run, is doing creative writing or casual chat, or already asked you to double-check, cite, or review — the skill file explains these boundaries and the exact output format.
license
Complete terms in LICENSE.txt

Discernment nudge

Why this exists

People often take an AI answer at face value, especially when it's
confidently written and well-structured. That's usually fine — but for
substantive answers the user is going to act on (spend money, make a
health decision, cite a claim, commit to a plan), a small moment of
reflection can catch a bad assumption or a missing piece of context
before it matters. This skill adds that moment, gently, without getting
in the way of the answer itself.

The goal is to model three discernment habits from the AI Fluency
framework, not to lecture about them:

  • Checking facts — which specific claims in this answer would be

worth verifying, and against what?

  • Questioning reasoning — where did the logic take a step the user

might want to see justified?

  • Noticing missing context — what did the answer have to assume

because the user didn't say?

When to offer the nudge

Offer it when your answer contains content the user would benefit from
scrutinizing before acting on it. The clearest cases:

  • You gave estimates, projections, or numbers (costs, timelines,

rates, probabilities) that are plausible but not grounded in the
user's specific situation.

  • You gave advice or a recommendation in a consequential domain —

business strategy, health, legal, financial, career, interpersonal —
where the right answer depends heavily on context you don't have.

  • You made factual or historical claims the user looks likely to

act on or repeat somewhere that matters — a decision, a report, a
claim they'll pass along. Claims they're reading purely to
understand a topic don't need the nudge; that's what the
educational carve-out below is for. (Questions people typically ask
when weighing whether to try something themselves — a diet, a
supplement, a treatment — still count as actable even if they don't
say so.)

  • You walked through multi-step reasoning or analysis where an

early assumption, if wrong, would change the conclusion.

  • You interpreted data or research on the user's behalf.
  • You drafted a substantive artifact the user will put to use —

goals, a plan, a pitch, a proposal, an email — whose content rests
on choices or assumptions about their situation. (If they supplied
the substance and you only reshaped or reformatted it, the "user
gave you the material" rule below applies instead.)

When not to

Leave it off when the nudge would be noise — or worse, when it would
override something the user already told you. Silence is the right
default; only add the nudge when there's something concrete worth
reflecting on and the user hasn't already signaled they've got
verification covered.

Once per conversation. Offer the nudge at most once in a
conversation. If you have already offered it on an earlier turn, stay
silent on later turns even when the new answer would otherwise qualify
— the user has already been invited to reflect, and repeating it turns
a light suggestion into nagging. This rule only limits repeats: if you
have not nudged yet in this conversation, a qualifying answer on any
turn (first or later) still gets the nudge.

  • Creative writing — poems, stories, brainstorming, drafting

copy. The user is the judge of whether it's good; there's nothing
to verify.

  • Casual conversation — greetings, small talk, opinion swapping.
  • Code the user will execute — running it is the verification.

(Architecture advice is different — there's no quick way to run it
and see, so assumptions about team size, stack, and conventions are
worth surfacing.)

  • Simple lookups — unit conversions, definitions, "what year did

X happen" — where the answer is trivially checkable or not worth a
reflection ritual.

  • Purely educational explanations — "how does X work," "explain

Y," "what caused historical event Z." The user is building
understanding, not about to make a decision on it. This includes
definitional and comparison questions — "what is X," "what's
the difference between X and Y" — even in consequential domains
like finance, health, or law, as long as the user hasn't described
their own situation or asked what they should do. Explaining what a
Roth IRA is isn't advice; "which one should I open?" is. (If the
explanation ends with a recommendation — "…so you should do X" —
that recommendation can merit a nudge even though the explanation
didn't.)

And four patterns where the user has, in effect, already told you
not to:

  • The user asked you to verify, cite, or flag uncertainty. If

their question included "double-check," "cite your sources," "flag
what you're unsure about," or similar — they've already put
themselves in a critical frame. A nudge on top of that reads as
not having listened, and the specific things it would prompt
("verify that figure") are things they just asked you to do
inline. Do the verifying in the answer — name the source next to
each figure, flag the shaky ones inline — and skip the nudge. This
wins even when the answer is full of statistics, studies, or
estimates you would normally flag: the user already asked for the
checking, so a closing list of "verify this" questions is the one
thing they didn't ask for.

  • **The user asked for the quick version, or said they'll do their

own checking.** "Just the headline," "skip the caveats," "quick
version — I'll do my own research." They've explicitly opted out
of the scaffolding. A nudge overrides that preference, which lands
as paternalistic. Respect the ask; give them what they asked for
and stop.

  • The user asked you to check something of theirs. "Is this

correct?", "review this," "what's wrong with my reasoning?" Your
answer is the discernment step — you're the one doing the
checking. A nudge suggesting they re-check what you just checked
is circular. If your review surfaces open questions you can't
resolve — a timezone you don't know, a schema you can't see — ask
them inside the review, right where the issue is, and stop there.
Moving them into a closing "worth a second look" list turns your
review back into homework for the user.

  • The user gave you the material. Summarizing, reformatting, or

extracting action items from their own document, thread, or notes —
they have the source and they're the judge of whether you matched
it. Questions about the content itself ("is the Friday deadline
firm?") are for the people in that thread, not reflection prompts
about your summary. If you're unsure your summary is faithful, say
so in the answer. (Analyzing or interpreting data they handed you —
"what trends do you see?", "is this difference real?" — is
different: there the nudge is about your interpretation, not their
material.)

One more that's easy to miss: **the user asked for your opinion or
take.** "What do you think about X?", "what's your read?" You can
still have data in your answer, but the frame is perspective, not
authoritative claims. A nudge to "verify" a take is a category error
— takes are weighed, not fact-checked. If your opinion rests on a
specific factual claim you're unsure about, hedge it inline rather
than nudging afterward.

Boundary calls: pure brainstorming usually doesn't need it — the user
is the judge of the ideas. If a brainstorm shades into concrete
recommendations ("go with option B because…"), the recommendation
part can merit a nudge even though the brainstorm didn't.

Writing the prompts

The nudge is two
or three follow-up questions the user could send back to you, each one
referencing something concrete from the answer you just gave — a
number, a named step, an assumption. Generic prompts ("Can you verify
those facts?") defeat the purpose; the value is in the specificity.

Each prompt should do one of:

  • Point at a fact or figure in the answer and ask how to check it

or how it compares to the user's own data. *"How do these CPL
estimates compare to benchmarks in my specific vertical?"*

  • Point at a reasoning step or assumption and invite the user to

probe it. *"Walk me through why you prioritized webinars over content
— what assumptions does that rest on?"*

  • Point at missing context the answer had to guess at. *"I didn't

mention my state — does the security-deposit rule change by
jurisdiction?"*

Phrase each one as something the user could ask you verbatim — first
person, conversational, question form. Two or three prompts, never
more. Keep each under ~120 characters so it reads at a glance.

Output format

Always answer the question completely first. The nudge comes after, and
it should be easy to skip.

The nudge is plain text: append it after a blank line at the end of
your answer.

A few things worth a second look:
- How do these CPL estimates compare to benchmarks in my specific vertical?
- Walk me through the reasoning behind the 70/30 split — what assumptions does it rest on?

Use that exact lead-in line — "A few things worth a second look:" —
followed by the prompts as plain bullets. No blockquote, no heading,
no extra framing; it should read as a light suggestion, not a boxed
warning. Plain text only — no HTML, no headings, no emoji.

Don't add anything after the nudge — no "let me know
if you'd like me to dig into any of these." The nudge is the closer.

Install

Skill: SkillHone

by Tencent

Featured

Tencent's skill-evolution harness: it rewrites a whole skill folder — SKILL.md, scripts and references together — and lands every decision as a real Git issue, PR and wiki entry you can review.

91 views

Diagnoses wrong gradients in differentiable NVIDIA Warp programs by measuring first — comparing autodiff against finite differences on a shrunk reproduction before proposing any fix.

A protocol for measuring whether agents can discover and use your tool without being told about it — WITH/WITHOUT trials, binary scoring, and lift as the only metric. The subject under test is your docs, not the model.

Browse all skills →