blindspot-pass

Survey codebase territory and domain constraints to identify unknown unknowns.

3|Updated May 12, 2026
One-click install
npx skills add https://github.com/gao-hongnan/omniagents --skill blindspot-pass
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: blindspot-pass
Source: https://github.com/gao-hongnan/omniagents/tree/main/plugins/unknowns/skills/blindspot-pass
Command: npx skills add https://github.com/gao-hongnan/omniagents --skill blindspot-pass

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This skill solves the problem of "unknown unknowns"—the critical gaps in understanding that occur when a user attempts to build in an unfamiliar codebase or domain, preventing costly rework and misaligned implementation.

Core Features & Use Cases

  • Territory Surveying: Systematically maps the codebase or domain to identify deltas between the user's mental model and the actual technical reality.
  • Strategic Reframing: Provides actionable insights that force a re-evaluation of the task before code is written, ensuring the right problem is being solved.
  • Use Case: Use this before starting a major refactor in a module you have never touched to uncover hidden dependencies, historical landmines, and implicit conventions that would otherwise cause your PR to be rejected.

Quick Start

Run the blindspot-pass skill by providing the task description and your current level of familiarity with the relevant codebase and domain.

Frequently Asked Questions about blindspot-pass

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

FAQPage Schema
How do I identify unknown unknowns before refactoring an unfamiliar codebase?

To identify unknown unknowns before refactoring, you survey the codebase territory and domain constraints to bridge the gap between user intent and technical reality. This prevents costly rework by validating every identified blindspot with specific file paths and lines.

What is codebase reconnaissance and how does it prevent misaligned implementation?

Codebase reconnaissance is systematically mapping the codebase or domain to identify deltas between your mental model and actual technical reality. It provides actionable insights that force a strategic reframing of the task before code is written, preventing misaligned implementation.

How do I scope architectural changes in an unfamiliar module safely?

Scoping architectural changes safely requires evidence-based reconnaissance to uncover historical landmines and hidden dependencies. By validating identified blindspots with specific file paths and lines, you ensure your architectural scoping aligns with actual technical reality rather than assumptions.

Can I use this approach for onboarding into unfamiliar modules without prior domain knowledge?

Yes, you can use this approach for onboarding into unfamiliar modules without prior domain knowledge. By surveying codebase territory and domain constraints, it bridges the gap between your current familiarity level and the technical reality, exposing implicit conventions you need to learn.

What's the best way to find hidden dependencies before starting a major codebase refactor?

The best way to find hidden dependencies before a major codebase refactor is to perform a systematic territory survey mapping the domain. This evidence-based reconnaissance validates every identified blindspot by citing specific file paths and lines, ensuring your PR is not rejected due to missed historical landmines.