Skip to content

GreatMark/fable-field-guide-skills / skills/blindspot-pass

blindspot-pass

Verified

Surface the user's unknown unknowns before they start work in an unfamiliar area (new codebase area, domain, or tool). Produces a read-only blindspot briefing plus advice on how to prompt better. Use when the user says "blindspot pass", "盲区扫描", "unknown unknowns", asks what they don't know or might miss before diving in, says "我刚接手这块代码", "开工前帮我看看有什么坑", or merely describes facing unfamiliar territory — the statement is the request. Not for finished or pre-merge work (use change-quiz), nor for interviewing the user (use interview-me); mixed requests start here — brief, then hand off.

FileKindSize
SKILL.mdskill md4.1 KB
---
name: blindspot-pass
description: >-
  Surface the user's unknown unknowns before they start work in an unfamiliar
  area (new codebase area, domain, or tool). Produces a read-only blindspot
  briefing plus advice on how to prompt better. Use when the user says
  "blindspot pass", "盲区扫描", "unknown unknowns", asks what they don't know
  or might miss before diving in, says "我刚接手这块代码",
  "开工前帮我看看有什么坑", or merely describes facing unfamiliar territory —
  the statement is the request. Not for finished or pre-merge work (use
  change-quiz), nor for interviewing the user (use interview-me); mixed
  requests start here — brief, then hand off.
---

# Blindspot Pass

Help the user discover their unknown unknowns before work starts. This is a
read-only pass: do not modify any files.

## Workflow

1. **Anchor on the user's starting point.** If not already clear from the
   conversation, ask once — a single short message, at most three
   sub-questions — about their experience with this problem and codebase,
   what they have already decided, and what they plan to do next. If asking
   is not possible (e.g. an unattended/CI run), the user deflects ("just
   go"), or the reply does not answer the questions, state your assumptions
   in one line — folding in whatever they did say — and proceed.
2. **Explore the territory.** Start from the files the task will touch — or,
   when the user is adopting an area rather than doing one task, its entry
   points (public API, main module, README) — and expand outward: direct
   dependencies/dependents, tests, docs, then git history of the touched
   files (not the whole repo). If history is unavailable (tarball, shallow
   clone, fresh repo) or the area is not code, use its changelog, release
   notes, or prior internal write-ups instead. For non-code areas (a SaaS
   tool, a business decision), expand the same way through official docs
   and pricing, adoption and migration post-mortems from other teams, the
   vendor's changelog and viability, and compliance constraints. In large
   codebases, cap this pass at roughly 15-25 file reads/searches: follow
   the 2-3 leads most likely to change the user's approach; if a lead
   stalls (slow search, missing tooling), drop it after one retry; when you
   hit the cap, stop and report, listing unexplored areas explicitly as
   unswept corners. If the domain is unfamiliar to you or fast-moving,
   search the web. Look specifically for things the user did not mention in
   their description of the task.
3. **Report blindspots** directly in the chat response, in the language of the
   conversation (do not create files unless the user asks for a document),
   organized as:
   - **Questions you didn't know to ask** — decisions hidden in this area
     (existing conventions, invariants, feature flags, edge cases; for
     non-code: pricing-tier traps, data-export paths, compliance).
   - **What "good" looks like** — quality bars, reference implementations, or
     prior art the user should calibrate against.
   - **History and potholes** — past attempts, known pitfalls, TODO/FIXME
     landmines, coupling that will bite.
   - **Domain concepts** — if the domain is new to the user, teach the 3-5
     concepts they need to evaluate results (not an encyclopedia).
4. **End with "how to prompt me better":** 3-6 concrete things the user should
   specify in their next prompt now that these blindspots are visible. If
   "what good looks like" surfaced a concrete reference worth copying,
   suggest reference-hunt. If the remaining ambiguities would change the
   approach, can only be decided by the user, the session is interactive,
   and the user has not declined to answer questions, suggest running
   interview-me next; otherwise end after the prompt advice. If the area
   was simple (see Rules), shrink or skip this section.

## Rules

- Prioritize blindspots that would change the user's approach; skip trivia.
- Cite checkable sources: file paths + line numbers, or URLs / commit hashes.
- If the area turns out to be simple with few blindspots, say so plainly
  instead of inventing findings.
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 322kUpdated Claude CodeCodexVerifiedInstall