hallucination-detector

Validate technology suggestions against the project's documented tech stack and codebase.

91|10|Updated Oct 4, 2025
One-click install
npx skills add https://github.com/marcusgoll/Spec-Flow --skill hallucination-detector
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: hallucination-detector
Source: https://github.com/marcusgoll/Spec-Flow/tree/main/.codex/skills/hallucination-detector
Command: npx skills add https://github.com/marcusgoll/Spec-Flow --skill hallucination-detector

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Detects and blocks hallucinated technical decisions by validating choices against the project's documented tech stack and references.

Core Features & Use Cases

  • Validate frameworks, APIs, databases against tech-stack docs
  • Require evidence/citation for all tech claims
  • Block suggestions that violate architecture

Quick Start

Auto-detect suggested technology and compare against docs/project/tech-stack.md; provide corrected, evidence-backed alternative.

Frequently Asked Questions about hallucination-detector

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I detect hallucinated technology recommendations in my project?

Hallucination detection validates all technology suggestions against your documented tech stack and existing codebase. It compares recommended frameworks, libraries, APIs, and databases against docs/project/tech-stack.md to block suggestions that don't align with your project's actual architecture and require evidence for every claim.

Can I validate framework and library suggestions against my project's tech stack?

Yes. The validator loads your tech stack documentation, verifies that suggested frameworks, libraries, and APIs actually exist in your codebase, and blocks recommendations that violate your documented architecture. All suggestions must be backed by citations from your existing technology choices.

How do I ensure database and API recommendations match my project setup?

Validation compares suggested database schemas and APIs against your project's documented tech stack and existing codebase. Mismatches are caught and corrected with evidence-backed alternatives that reflect your actual project technology.

What happens when a technical recommendation doesn't match my documented architecture?

The detector blocks violations and provides corrected alternatives that align with your tech stack. Every suggestion requires citation from your docs/project/tech-stack.md or existing codebase, preventing unsupported architectural decisions.

Do I need to manually maintain my tech stack documentation for this to work?

Yes. The validator requires an up-to-date docs/project/tech-stack.md file that lists your frameworks, libraries, databases, APIs, and cloud services. This reference document is compared against all technology recommendations during feature work.

Can this catch hallucinations in cloud service and architectural pattern suggestions?

Yes. Detection applies to frameworks, libraries, APIs, database schemas, cloud services, and architectural patterns. All technology recommendations—whether during feature development or architectural decisions—are validated against your documented tech stack and existing codebase.