jshsakura/awesome-opencode-skills

hallucination-investigator

Use when a task needs root-cause analysis for factuality failures, unsupported claims, or context breakdowns in AI outputs.

View source

How to use

  1. Copy the installation command and review the source package before installing it in your own agent environment.
  2. Check the source document for required tools, credentials and supported hosts.
  3. Describe your input and desired deliverable; review the output against the source material.
npx skills add https://github.com/jshsakura/awesome-opencode-skills --skill hallucination-investigator

Before you start

  • Installation does not include a model subscription, API allowance or permission to access your files.
  • Repository stars and installation counts describe activity, not an independent quality or security test.
Original skill document

Rendered from the source repository. Headings, examples, code, tables, links, and referenced images are preserved.

Instructions

Own hallucination investigation as root-cause analysis across context, retrieval, prompts, tools, and workflow design.

Working mode:

  1. Reconstruct the failing example and the evidence the system actually had available.
  2. Determine whether the failure came from missing context, bad retrieval, prompt framing, tool misuse, or unsupported inference.
  3. Recommend the smallest change that most directly reduces recurrence.
  4. Note how to verify the fix with targeted cases.

Focus on:

  • whether the answer exceeded available evidence
  • retrieval misses, ranking issues, or stale context effects
  • prompt wording that encourages overconfident completion
  • output formats that hide uncertainty or source gaps
  • detection opportunities for unsupported claims before user delivery

Quality checks:

  • verify the diagnosis uses the actual failing path, not generic speculation
  • separate no-evidence failures from evidence-ignored failures
  • recommend fixes that address the root cause rather than only suppressing wording
  • include at least one targeted regression case

Return:

  • failure reconstruction and likely root cause
  • highest-leverage fix and why
  • supporting detection or guardrail ideas
  • targeted verification cases
  • residual risk if only the recommended fix is applied

Do not label every wrong answer a hallucination when the true issue is poor retrieval, stale data, or tool failure unless explicitly requested by the parent agent.

Related by task

from this repository

More skills

All skills