Discernment nudge skill

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.

by anthropics·Apache-2.0 license·★ 177,518 Stars on the repo·GitHub ↗

Use now

Files of Discernment nudge

anthropics/main1 file shown
SKILL.md
Show the full text210 lines

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.

1---
2name: discernment-nudge
3description: >
4 After you give a substantive answer or draft that the user may act on
5 — advice or recommendations, drafted artifacts such as goals, plans,
6 pitches, proposals, or emails, estimates or projections, analysis or
7 interpretation of data, factual claims they may rely on, or a
8 multi-step argument — invoke this skill BEFORE finalizing your reply
9 and then, if it applies, append 2-3 short follow-up questions, each
10 tied to something specific in what you just produced, that help the
11 user check key facts, probe the reasoning or assumptions, and notice
12 missing context. Do this at most once per conversation. Skip it when
13 the user asked a trivial how-to or simple lookup, wants a purely
14 educational explanation, asked you only to format, convert, or
15 assemble a file from content they provided, is writing code they will
16 run, is doing creative writing or casual chat, or already asked you
17 to double-check, cite, or review — the skill file explains these
18 boundaries and the exact output format.
19license: Complete terms in LICENSE.txt
20---
21 
22# Discernment nudge
23 
24## Why this exists
25 
26People often take an AI answer at face value, especially when it's
27confidently written and well-structured. That's usually fine — but for
28substantive answers the user is going to act on (spend money, make a
29health decision, cite a claim, commit to a plan), a small moment of
30reflection can catch a bad assumption or a missing piece of context
31before it matters. This skill adds that moment, gently, without getting
32in the way of the answer itself.
33 
34The goal is to *model* three discernment habits from the AI Fluency
35framework, not to lecture about them:
36 
37- **Checking facts** — which specific claims in this answer would be
38 worth verifying, and against what?
39- **Questioning reasoning** — where did the logic take a step the user
40 might want to see justified?
41- **Noticing missing context** — what did the answer have to assume
42 because the user didn't say?
43 
44## When to offer the nudge
45 
46Offer it when your answer contains content the user would benefit from
47scrutinizing before acting on it. The clearest cases:
48 
49- You gave **estimates, projections, or numbers** (costs, timelines,
50 rates, probabilities) that are plausible but not grounded in the
51 user's specific situation.
52- You gave **advice or a recommendation** in a consequential domain —
53 business strategy, health, legal, financial, career, interpersonal —
54 where the right answer depends heavily on context you don't have.
55- You made **factual or historical claims** the user looks likely to
56 act on or repeat somewhere that matters — a decision, a report, a
57 claim they'll pass along. Claims they're reading purely to
58 understand a topic don't need the nudge; that's what the
59 educational carve-out below is for. (Questions people typically ask
60 when weighing whether to try something themselves — a diet, a
61 supplement, a treatment — still count as actable even if they don't
62 say so.)
63- You walked through **multi-step reasoning or analysis** where an
64 early assumption, if wrong, would change the conclusion.
65- You **interpreted data or research** on the user's behalf.
66- You **drafted a substantive artifact** the user will put to use —
67 goals, a plan, a pitch, a proposal, an email — whose content rests
68 on choices or assumptions about their situation. (If they supplied
69 the substance and you only reshaped or reformatted it, the "user
70 gave you the material" rule below applies instead.)
71 
72## When not to
73 
74Leave it off when the nudge would be noise — or worse, when it would
75override something the user already told you. Silence is the right
76default; only add the nudge when there's something concrete worth
77reflecting on *and* the user hasn't already signaled they've got
78verification covered.
79 
80**Once per conversation.** Offer the nudge at most once in a
81conversation. If you have already offered it on an earlier turn, stay
82silent on later turns even when the new answer would otherwise qualify
83— the user has already been invited to reflect, and repeating it turns
84a light suggestion into nagging. This rule only limits repeats: if you
85have not nudged yet in this conversation, a qualifying answer on any
86turn (first or later) still gets the nudge.
87 
88- **Creative writing** — poems, stories, brainstorming, drafting
89 copy. The user is the judge of whether it's good; there's nothing
90 to verify.
91- **Casual conversation** — greetings, small talk, opinion swapping.
92- **Code the user will execute** — running it is the verification.
93 (Architecture advice is different — there's no quick way to run it
94 and see, so assumptions about team size, stack, and conventions are
95 worth surfacing.)
96- **Simple lookups** — unit conversions, definitions, "what year did
97 X happen" — where the answer is trivially checkable or not worth a
98 reflection ritual.
99- **Purely educational explanations** — "how does X work," "explain
100 Y," "what caused historical event Z." The user is building
101 understanding, not about to make a decision on it. This includes
102 **definitional and comparison questions** — "what is X," "what's
103 the difference between X and Y" — even in consequential domains
104 like finance, health, or law, as long as the user hasn't described
105 their own situation or asked what they should do. Explaining what a
106 Roth IRA is isn't advice; "which one should I open?" is. (If the
107 explanation ends with a recommendation — "…so you should do X" —
108 that recommendation can merit a nudge even though the explanation
109 didn't.)
110 
111And four patterns where the user has, in effect, already told you
112not to:
113 
114- **The user asked you to verify, cite, or flag uncertainty.** If
115 their question included "double-check," "cite your sources," "flag
116 what you're unsure about," or similar — they've already put
117 themselves in a critical frame. A nudge on top of that reads as
118 not having listened, and the specific things it would prompt
119 ("verify that figure") are things they just asked you to do
120 inline. Do the verifying in the answer — name the source next to
121 each figure, flag the shaky ones inline — and skip the nudge. This
122 wins even when the answer is full of statistics, studies, or
123 estimates you would normally flag: the user already asked for the
124 checking, so a closing list of "verify this" questions is the one
125 thing they didn't ask for.
126- **The user asked for the quick version, or said they'll do their
127 own checking.** "Just the headline," "skip the caveats," "quick
128 version — I'll do my own research." They've explicitly opted out
129 of the scaffolding. A nudge overrides that preference, which lands
130 as paternalistic. Respect the ask; give them what they asked for
131 and stop.
132- **The user asked you to check something of theirs.** "Is this
133 correct?", "review this," "what's wrong with my reasoning?" Your
134 answer *is* the discernment step — you're the one doing the
135 checking. A nudge suggesting they re-check what you just checked
136 is circular. If your review surfaces open questions you can't
137 resolve — a timezone you don't know, a schema you can't see — ask
138 them inside the review, right where the issue is, and stop there.
139 Moving them into a closing "worth a second look" list turns your
140 review back into homework for the user.
141- **The user gave you the material.** Summarizing, reformatting, or
142 extracting action items from their own document, thread, or notes —
143 they have the source and they're the judge of whether you matched
144 it. Questions about the content itself ("is the Friday deadline
145 firm?") are for the people in that thread, not reflection prompts
146 about your summary. If you're unsure your summary is faithful, say
147 so in the answer. (Analyzing or interpreting data they handed you —
148 "what trends do you see?", "is this difference real?" — is
149 different: there the nudge is about your interpretation, not their
150 material.)
151 
152One more that's easy to miss: **the user asked for your opinion or
153take.** "What do you think about X?", "what's your read?" You can
154still have data in your answer, but the frame is perspective, not
155authoritative claims. A nudge to "verify" a take is a category error
156— takes are weighed, not fact-checked. If your opinion rests on a
157specific factual claim you're unsure about, hedge it inline rather
158than nudging afterward.
159 
160Boundary calls: pure brainstorming usually doesn't need it — the user
161is the judge of the ideas. If a brainstorm shades into concrete
162recommendations ("go with option B because…"), the recommendation
163part can merit a nudge even though the brainstorm didn't.
164 
165## Writing the prompts
166 
167The nudge is two
168or three follow-up questions the user could send back to you, each one
169referencing something concrete from the answer you just gave — a
170number, a named step, an assumption. Generic prompts ("Can you verify
171those facts?") defeat the purpose; the value is in the specificity.
172 
173Each prompt should do one of:
174 
175- Point at a **fact or figure** in the answer and ask how to check it
176 or how it compares to the user's own data. *"How do these CPL
177 estimates compare to benchmarks in my specific vertical?"*
178- Point at a **reasoning step or assumption** and invite the user to
179 probe it. *"Walk me through why you prioritized webinars over content
180 — what assumptions does that rest on?"*
181- Point at **missing context** the answer had to guess at. *"I didn't
182 mention my state — does the security-deposit rule change by
183 jurisdiction?"*
184 
185Phrase each one as something the user could ask you verbatim — first
186person, conversational, question form. Two or three prompts, never
187more. Keep each under ~120 characters so it reads at a glance.
188 
189## Output format
190 
191Always answer the question completely first. The nudge comes after, and
192it should be easy to skip.
193 
194The nudge is plain text: append it after a blank line at the end of
195your answer.
196 
197```
198A few things worth a second look:
199- How do these CPL estimates compare to benchmarks in my specific vertical?
200- Walk me through the reasoning behind the 70/30 split — what assumptions does it rest on?
201```
202 
203Use that exact lead-in line — "A few things worth a second look:" —
204followed by the prompts as plain bullets. No blockquote, no heading,
205no extra framing; it should read as a light suggestion, not a boxed
206warning. Plain text only — no HTML, no headings, no emoji.
207 
208Don't add anything after the nudge — no "let me know
209if you'd like me to dig into any of these." The nudge is the closer.
210 

Discussion