Mmcp.market

discernment-nudge skill

by anthropics·anthropics/skills·179k stars

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.

A100/100content scan

Is the discernment-nudge skill safe?

Clean: nothing in its files matched our rules. We read 2 files in the folder on 2026-09-28.

No findings.

Install the discernment-nudge skill

A skill is a folder. Copy it into your agent's skills folder and the agent loads it when the task matches its description.

git clone --depth 1 https://github.com/anthropics/skills.git /tmp/skills
mkdir -p ~/.claude/skills
cp -r /tmp/skills/skills/discernment-nudge ~/.claude/skills/discernment-nudge
available in every project

In the Claude apps, zip the folder and upload it from the Skills settings. The folder on GitHub

The instructions your agent would load

SKILL.md as published, without the frontmatter. Read it on GitHub

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:

worth verifying, and against what?

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

might want to see justified?

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

because the user didn't say?

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

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:

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

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

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

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

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 made factual or historical claims the user looks likely to

early assumption, if wrong, would change the conclusion.

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

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.)

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

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.

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

  • Creative writing — poems, stories, brainstorming, drafting

(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.)

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

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

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

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.)

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

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

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 you to verify, cite, or flag uncertainty. If

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 for the quick version, or said they'll do their

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 asked you to check something of theirs. "Is this

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.)

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

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:

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 fact or figure in the answer and ask how to check it

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

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

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

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

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.

More skills from anthropics/skills

  • Aacademy-guideStop and check this skill before finishing any reply to a question about how to use Claude or a Claude product — it recommends matching courses, tutorials, and use cases from Claude Academy (academy.claude.com), Anthropic's learning hub. Trigger on: "how do I", "how can I", "getting started with", "what can Claude do", "teach me", "learn to use"; questions about artifacts, projects, skills, plugins, connectors, MCP; requests about rolling Claude out to a team, class, or organization; and any ask for training materials, onboarding content, or learning resources. Use it when the user is learning how to use a feature or product — not when they are mid-task and just want the task done. This skill composes with other skills: after consulting product documentation to answer how a Claude feature works, also check here for a matching course or tutorial — a docs-grounded answer and an Academy recommendation belong together. Only recommend on a strong match; never invent Academy content.
  • Aalgorithmic-artCreating algorithmic art using p5.js with seeded randomness and interactive parameter exploration. Use this when users request creating art using code, generative art, algorithmic art, flow fields, or particle systems. Create original algorithmic art rather than copying existing artists' work to avoid copyright violations.
  • Abrand-guidelinesApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply.
  • Acanvas-designCreate beautiful visual art in .png and .pdf documents using design philosophy. You should use this skill when the user asks to create a poster, piece of art, design, or other static piece. Create original visual designs, never copying existing artists' work to avoid copyright violations.
  • Aclaude-apiReference for the Claude API / Anthropic SDK — model ids, pricing, params, streaming, tool use, MCP, agents, caching, token counting, model migration. TRIGGER — read BEFORE opening the target file; don't skip because it "looks like a one-liner" — whenever: the prompt names Claude/Anthropic in any form (Claude, Anthropic, Fable, Opus, Sonnet, Haiku, `anthropic`, `@anthropic-ai`, `claude-*`, `us.anthropic.*`, `[1m]`); the user asks about an LLM (pricing/model choice/limits/caching) — never answer from memory; OR the task is LLM-shaped with provider unstated (agent/MCP/tool-definition/multi-agent/RAG/LLM-judge/computer-use; generate/summarize/extract/classify/rewrite/converse over NL; debugging refusals/cutoffs/streaming/tool-calls/tokens). SKIP only when another provider is being worked on (overrides all triggers): OpenAI/GPT/Gemini/Llama/Mistral/Cohere/Ollama named in the query; OR `grep -rE 'openai|langchain_openai|google.generativeai|genai|mistralai|cohere|ollama'` over the project hits (run this grep FIRST if no provider named — don't Read the file).
  • Adoc-coauthoringGuide users through a structured workflow for co-authoring documentation. Use when user wants to write documentation, proposals, technical specs, decision docs, or similar structured content. This workflow helps users efficiently transfer context, refine content through iteration, and verify the doc works for readers. Trigger when user mentions writing docs, creating proposals, drafting specs, or similar documentation tasks.
  • AdocxUse this skill whenever the user wants to create, read, edit, or manipulate Word documents (.docx files) or Word templates (.dotx files). Triggers include: any mention of 'Word doc', 'word document', '.docx', '.dotx', or requests to produce professional documents with formatting like tables of contents, headings, page numbers, or letterheads. Also use when extracting or reorganizing content from .docx or .dotx files, inserting or replacing images in documents, performing find-and-replace in Word files, working with tracked changes or comments, or converting content into a polished Word document. If the user asks for a 'report', 'memo', 'letter', 'template', or similar deliverable as a Word or .docx file, use this skill. Do NOT use for PDFs, spreadsheets, Google Docs, or general coding tasks unrelated to document generation.
  • Afrontend-designGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults.
  • Ainternal-commsA set of resources to help me write all kinds of internal communications, using the formats that my company likes to use. Claude should use this skill whenever asked to write some sort of internal communications (status reports, leadership updates, 3P updates, company newsletters, FAQs, incident reports, project updates, etc.).
  • Amcp-builderGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).
  • ApdfUse this skill whenever the user wants to do anything with PDF files. This includes reading or extracting text/tables from PDFs, combining or merging multiple PDFs into one, splitting PDFs apart, rotating pages, adding watermarks, creating new PDFs, filling PDF forms, encrypting/decrypting PDFs, extracting images, and OCR on scanned PDFs to make them searchable. If the user mentions a .pdf file or asks to produce one, use this skill.
  • ApptxUse this skill any time a .pptx or .potx file is involved in any way — as input, output, or both. This includes: creating slide decks, pitch decks, or presentations; reading, parsing, or extracting text from any .pptx or .potx file (even if the extracted content will be used elsewhere, like in an email or summary); editing, modifying, or updating existing presentations; combining or splitting slide files; working with templates (.potx), layouts, speaker notes, or comments. Trigger whenever the user mentions \"deck,\" \"slides,\" \"presentation,\" or references a .pptx or .potx filename, regardless of what they plan to do with the content afterward. If a .pptx or .potx file needs to be opened, created, or touched, use this skill.

All agent skills → · MCP servers