agent-interface-design
Design tools, scripts, and CLIs that an agent will call, so the interface teaches its own use instead of a wall of prose and…
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.
$ npx -y skills add Neeeophytee/finding-unknowns-skills --skill blindspot-pass --agent claude-codeHow it fires
How this skill gets triggered: by you, by Claude, or both.
/blindspot-passContext preview
The summary Claude sees to decide when to auto-load this skill.
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.
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."
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.
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:
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.
14 installable skills that help your coding agent find what you don't know — before it gets expensive to fix. The map is not the territory. Your prompt is a map; the codebase and the real world are the territory.
Design tools, scripts, and CLIs that an agent will call, so the interface teaches its own use instead of a wall of prose and…
Test a consequential technical assumption with a small, falsifiable experiment before committing to an approach. Use when a plan…
Generate several genuinely different throwaway variations (designs, approaches, drafts) for the user to react to. Use when the…
After a working session, produce a report on what changed plus a quiz the user must pass before merging. Use when the user asks…
Audit the instructions an agent already carries — CLAUDE.md, AGENTS.md, skills, tool descriptions — for contradictions,…
Keep a running implementation-notes.md during a build, logging every deviation from the plan and every discovered edge case. Use…