Reference Grounding Checker

Before an agent acts on a plan, verify that the things it named actually exist.

Install
cmdop skills install agensi-reference-grounding-checker

What it does

The Reference Grounding Checker acts as a pre-execution safety layer for AI agents. It scans proposed implementation plans to verify that every file path, function name, import statement, and environment variable mentioned actually exists within your local codebase. It eliminates "hallucinated" refactoring plans before they break your build.

Why use this skill

Even advanced LLMs frequently reference non-existent utility functions or assume the presence of configuration variables that aren't there. This skill provides a deterministic check against the ground truth of your file system and source code. It is significantly more reliable than standard prompting because it uses a specialized static analysis scanner to perform hard lookups, rather than relying on the model's memory of the repo.

Supported tools

  • Languages: Python, JavaScript, TypeScript.
  • Environments: Local repositories, CI/CD pipelines, and agentic workflows like Claude Code or Cursor.
  • Inputs: Markdown plans, text files, or direct chat history.

Expected Output

You receive a structured report detailing every reference checked, categorized findings by severity (e.g., Missing File, Unresolved Import), and specific remediation snippets to fix the plan's logic.