surveying-blind-spots

Surveys unfamiliar codebases or domains to surface unknown unknowns, gotchas, and dead ends.

Updated Mar 18, 2026
One-click install
npx skills add https://github.com/pgoell/pgoell-claude-tools --skill surveying-blind-spots-pgoell
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: surveying-blind-spots
Source: https://github.com/pgoell/pgoell-claude-tools/tree/main/plugins/learning/skills/surveying-blind-spots
Command: npx skills add https://github.com/pgoell/pgoell-claude-tools --skill surveying-blind-spots-pgoell

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When starting work in an unfamiliar codebase area or field, you cannot ask about what you cannot name. This Skill explores the target on your behalf and delivers a briefing of blind spots, gotchas, and vocabulary before you write a prompt or plan. ## Core Features & Use Cases - Codebase Pass: Dispatches a read-only exploration agent over a named module, mines git history for fix/revert/hack commits, and reads tests plus TODO/FIXME/HACK comments to surface known pain points. - Field Pass: Maps an unfamiliar domain's core concepts, vocabulary, standard tools, and classic beginner traps, verifying time-sensitive claims with web search. - Structured Briefing: Delivers unknown unknowns, evidenced gotchas, key vocabulary, rewritten prompts, and open questions ordered by likelihood of burning you. - Use Case: Before modifying an auth module you have never touched, run a blind-spot pass to learn its entry points, churn history, and conventions, then start your real task with eyes open. ## Quick Start Do a blind-spot pass on the auth module before I start planning changes to it.

Frequently Asked Questions about surveying-blind-spots

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

FAQPage Schema
How do I find blind spots before working in an unfamiliar codebase?

Run a blind-spot pass that explores the target area's entry points, config surface, and core files, then mines git history for fix, revert, and workaround commits. The result is a briefing of unknown unknowns, gotchas with evidence, and vocabulary for better prompting.

What is the difference between a blind-spot survey and being quizzed on a topic?

A blind-spot survey is a one-shot briefing that surfaces what you do not know, without testing or gating on mastery. Quizzing is a tutoring loop that teaches and verifies understanding; use it after the survey if you want to confirm comprehension.

Can a blind-spot pass work on non-code topics like a new field or domain?

Yes. For domains rather than code, the pass maps core concepts, search vocabulary, standard tools, and classic beginner traps from existing knowledge, then verifies version-sensitive or time-sensitive claims with web search.

When should I not use a blind-spot survey?

Skip it when you want to be taught to mastery, when you are ready to converge a design through Q and A, or when you need a cited multi-source research report. Those cases call for tutoring, brainstorming, or research skills instead.

How does git history help find codebase gotchas?

Reviewing recent commits for messages containing fix, revert, workaround, or hack reveals where previous developers hit dead ends. Repeated churn on one file marks a problem area, and TODO, FIXME, and HACK comments record gotchas the authors pinned deliberately.