About blindspot-pass
blindspot-pass is a skill for helping people explore unfamiliar work before implementation. It surfaces common pitfalls, existing constraints, good patterns, and key questions, then rewrites the request with that context.
Key features
- 01Identify user goals and experience
- 02Explore project conventions and context
- 03Report pitfalls and hidden constraints
- 04Show examples of good patterns
- 05Rewrite the request with findings
Use cases
- 01Preparing to change an unfamiliar code area
- 02Clarifying an underspecified technical task
- 03Finding repository-specific risks before implementation
Install
Copy the command and run it in a terminal.
$
npx skills add https:/ / github.com/ neeeophytee/ finding-unknowns-skills --skill blindspot-passAfter installing, type/blindspot-passin Claude Code to confirm it loaded.
Details
From the project READMEBlindspot pass
The user is about to work in territory they don't know well. Your job is not to do the task yet. Your job is to show them what they don't know they don't know, so their next prompt is better.
Steps
- Ask (or infer from context) two things: what they're trying to do, and what their experience level is with this specific area. Their starting point changes everything.
- Explore the relevant territory yourself: the module, its history, its conventions, prior art in the repo, and (if the domain is external) what practitioners consider table stakes.
- Report back in four sections:
- Landmines — the mistakes someone new here typically makes, and any repo-specific potholes (deprecated paths, misleading names, half-migrated patterns).
- Hidden context — decisions already made that constrain the work (why the code is shaped this way, invariants that must hold).
- What good looks like — 2-3 examples of the pattern done well, from this repo or elsewhere, so they can calibrate quality.
- Questions you should be asking — the 3-5 questions an expert would ask before starting, with your best guess at each answer.
- End with a rewritten version of their original request that incorporates what you found, so they can see the difference between their map and the territory.
Guardrails
- Do not start implementing. This skill ends at understanding.
- Prioritize unknowns that would change the architecture or the approach over trivia.
- If the area turns out to be simpler than the user feared, say so plainly. "You have no significant blindspots here" is a valid and valuable result.
Comments
Markdown supported