blindspot-pass — Claude Code skill: what it does, how to install
Surfaces architectural traps and hidden project constraints before any code is written. It turns vague tasks in unfamiliar domains into informed prompts.
npx skills add Neeeophytee/finding-unknowns-skills --skill blindspot-pass -a claude-codeWhat blindspot-pass does
This skill steps in before implementation starts, particularly when you navigate unfamiliar code or a new domain like video or infrastructure. The agent gathers your goal alongside your background in this area, then inspects repository history, patterns, and conventions.
The resulting report covers four distinct areas: landmines with misleading names or incomplete migrations, hidden architectural constraints, quality benchmarks, and questions an expert would ask. It concludes with an improved rewrite of your initial prompt.
By design, the skill writes zero code and strictly halts at understanding. If an area has no hidden gotchas, it plainly confirms that no significant blind spots exist.
What it helps with
- identify codebase landmines before editing unfamiliar modules
- uncover unwritten architectural constraints in legacy code
- rewrite ambiguous requests into precise agent prompts
- calibrate quality benchmarks using existing repository examples
Example prompts for the agent
- Run a blindspot pass before I touch the auth module.
- Find my unknown unknowns for adding video transcoding to this service.
- Check this codebase for hidden gotchas before I start refactoring the payment flow.
How to install blindspot-pass
1Skills CLI (Vercel)
npx skills add Neeeophytee/finding-unknowns-skills --skill blindspot-pass -a claude-code2Manually: put the files in place
~/.claude/skills/blindspot-pass/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/blindspot-pass/
1Skills CLI (Vercel)
npx skills add Neeeophytee/finding-unknowns-skills --skill blindspot-pass -a codex2Manually: put the files in place
.agents/skills/blindspot-pass/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add Neeeophytee/finding-unknowns-skills --skill blindspot-pass -a cursor2Manually: put the files in place
.cursor/skills/blindspot-pass/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install Neeeophytee/finding-unknowns-skills blindspot-pass2Manually: put the files in place
.github/skills/blindspot-pass/SKILL.md1Skills CLI (Vercel)
npx skills add Neeeophytee/finding-unknowns-skills --skill blindspot-pass -a gemini-cli2Platform CLI
gemini skills install https://github.com/Neeeophytee/finding-unknowns-skills --path skills/blindspot-passManually: put the files in place
.devin/skills/blindspot-pass/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add Neeeophytee/finding-unknowns-skills --skill blindspot-pass -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about blindspot-pass
How to install blindspot-pass in Claude Code?
Run npx skills add Neeeophytee/finding-unknowns-skills --skill blindspot-pass -a claude-code. You can also place the skill file directly at ~/.claude/skills/blindspot-pass/SKILL.md.
What does blindspot-pass do?
It reviews unfamiliar repository areas to flag hidden gotchas, constraints, and newcomer mistakes before work starts. It finishes by generating an updated, context-rich version of your prompt.
Does blindspot-pass write code?
No, the skill stops at analysis and intentionally avoids implementation. Its role is limited to surfacing blind spots and sharpening your directions.
Source text
SKILL.md · MIT
--- name: blindspot-pass description: Surface the user's unknown unknowns before work starts. Use when the user is entering an unfamiliar codebase area, an unfamiliar domain (design, video, infra), or explicitly asks for a "blindspot pass" or to find their "unknown unknowns." --- # Blindspot 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 1. 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. 2. 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. 3. 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. 4. 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.
© Neeeophytee · MIT · Neeeophytee/finding-unknowns-skills