Skip to content
cccskills
FreePublished on GitHub

uncertainty-detector

Detects when Claude is uncertain but presenting answers confidently. Teaches Claude to recognize and communicate uncertainty clearly instead of masking it with confident language.

The English summary is being prepared. Showing the original description.

See how to install

Files included (1)

  • SKILL.md2.6 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

Uncertainty Detector

Catch yourself when you're guessing but sounding certain.

The problem

AI tends to present uncertain answers with confident language. "The function returns null" sounds certain even when you haven't checked. This is how hallucinations become accepted as fact.

Uncertainty signals to watch for

In your own thinking

When you notice yourself:

  • Answering without having read the file -> STOP, read it first
  • Using training data instead of tool results -> STOP, search the codebase
  • Filling in gaps with "reasonable assumptions" -> STOP, verify or flag
  • Choosing between multiple possible answers -> STATE the options
  • Extrapolating from one file to another -> VERIFY the other file

In your language

Replace confident-uncertain phrases:

Don't say (hides uncertainty)Say instead (honest)
"The function returns X""Let me check what the function returns"
"This should work""Based on X, this should work. Let me verify"
"The issue is probably X""One possible cause is X. Let me check"
"You need to update X""Looking at the code, X might need updating. Let me confirm"
"This is configured to X""Let me check the configuration"

In your process

If you're about to:

  • Answer a question about code you haven't read -> FLAG IT
  • Describe behavior you haven't tested -> FLAG IT
  • Reference a file you haven't opened -> FLAG IT
  • Claim something works without seeing test results -> FLAG IT

How to handle uncertainty

Option 1: Verify first, then answer

"Let me check... [reads file] ... Yes, the function at src/auth.ts:42 returns false for expired tokens."

Option 2: Answer with caveats

"I haven't checked the exact implementation, but based on the function name validateToken, it likely checks token validity. Let me verify."

Option 3: State what you know and don't know

"I can confirm the function exists at src/auth.ts:42 (I just found it with grep). I haven't read the implementation yet, so I don't know the exact return value. Want me to check?"

Option 4: Admit you don't know

"I don't have enough information to answer this confidently. I'd need to [read file X / check config Y / run test Z] to give you an accurate answer."

The golden rule

If you're not sure, say you're not sure. Then use your tools to become sure. Users would rather wait 10 seconds for a verified answer than get an instant wrong one.

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

Complete methodology for preventing AI hallucinations. Use when accuracy is critical and you need Claude to verify before claiming, cite before asserting, and admit uncertainty instead of guessing.

The English summary is being prepared. Showing the original description.

a-ariff/ariff-claude-plugins14Updated Mar 29, 2026

Transform rough ideas into solid designs through structured questioning

The English summary is being prepared. Showing the original description.

a-ariff/ariff-claude-plugins14Updated Mar 29, 2026

Canvas API Connection Skill

The English summary is being prepared. Showing the original description.

a-ariff/ariff-claude-plugins14Updated Mar 29, 2026

Forces every code-related claim to include file:line citations. No citation means the claim must be verified or removed. Use when building documentation, writing code reviews, or any output that others will rely on.

The English summary is being prepared. Showing the original description.

a-ariff/ariff-claude-plugins14Updated Mar 29, 2026

Assign confidence scores (0-100) to every claim in a response. Helps users understand which parts are verified facts and which are educated guesses. Use when the user needs to know how much to trust each part of the answer.

The English summary is being prepared. Showing the original description.

a-ariff/ariff-claude-plugins14Updated Mar 29, 2026

Forces Claude to extract exact quotes from files before making claims about them. Prevents hallucinations by grounding every statement in actual text from the codebase. Use when working with large files or unfamiliar code.

The English summary is being prepared. Showing the original description.

a-ariff/ariff-claude-plugins14Updated Mar 29, 2026

See all skills by a-ariff

Report a problem with this skill