GitHub - Neeeophytee/finding-unknowns-skills: 8 installable skills for Claude Code and OpenAI Codex, for finding your unknowns before they get expensive: blindspot pass, brainstorms, interviews, references, plans, notes, pitches, and a merge quiz. Community distillation, not official Anthropic. · GitHub

/" data-turbo-transient="true" />

Skip to content

Search or jump to...

Search code, repositories, users, issues, pull requests...

-->

Search

Clear

Search syntax tips

Provide feedback

--><br>We read every piece of feedback, and take your input very seriously.

Include my email address so I can be contacted

Cancel

Submit feedback

Saved searches

Use saved searches to filter your results more quickly

-->

Name

Query

To see all available qualifiers, see our documentation.

Cancel

Create saved search

Sign in

/;ref_cta:Sign up;ref_loc:header logged out"}"<br>Sign up

Appearance settings

Resetting focus

You signed in with another tab or window. Reload to refresh your session.<br>You signed out in another tab or window. Reload to refresh your session.<br>You switched accounts on another tab or window. Reload to refresh your session.

Dismiss alert

{{ message }}

Neeeophytee

finding-unknowns-skills

Public

Notifications<br>You must be signed in to change notification settings

Fork<br>11

Star<br>119

main

BranchesTags

Go to file

CodeOpen more actions menu

Folders and files<br>NameNameLast commit message<br>Last commit date<br>Latest commit

History<br>4 Commits<br>4 Commits

.claude-plugin

.claude-plugin

skills

skills

.gitignore

.gitignore

AGENTS.md

AGENTS.md

CLAUDE.md

CLAUDE.md

EXAMPLES.md

EXAMPLES.md

LICENSE

LICENSE

README.md

README.md

View all files

Repository files navigation

Finding-Unknowns Skills

8 installable skills that make Claude help you 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. The gap between them is your unknowns, and with strong models the quality of the work is bottlenecked by how well you clarify them. These skills turn that idea, from Thariq Shihipar's essay A Field Guide to Fable: Finding Your Unknowns, into commands you can run in Claude Code, OpenAI Codex, or any agent that reads the agentskills.io SKILL.md format.

Community project. Distilled, with attribution, from a public essay by Thariq Shihipar (Anthropic, Claude Code team). Not an official Anthropic repository.

The idea in one table

Known<br>Unknown

Known<br>What's in your prompt<br>What you know you haven't figured out

Unknown<br>So obvious you'd never write it down, but you'd recognize it on sight<br>What you haven't considered at all

Every skill below is a cheap way to move something out of the bottom row before implementation makes it expensive.

The skills

Skill<br>Phase<br>One line

blindspot-pass<br>Before<br>Surface your unknown unknowns in an unfamiliar area, then help you prompt better

brainstorm-prototypes<br>Before<br>Throwaway variations you can react to, for taste you can't verbalize

interview-me<br>Before<br>One question at a time, architecture-changing questions first

reference-hunt<br>Before<br>Use working source code as the spec, even across languages

implementation-plan<br>Before<br>A plan that leads with the decisions you're most likely to change

implementation-notes<br>During<br>Log every deviation from the plan so the next attempt learns from this one

pitch-packager<br>After<br>Bundle spec + prototype + notes into a buy-in doc for reviewers

change-quiz<br>After<br>A comprehension quiz you must pass before you merge

Install

As a Claude Code plugin (all 8 skills):

/plugin marketplace add Neeeophytee/finding-unknowns-skills<br>/plugin install finding-unknowns@finding-unknowns-skills

Manually (pick the skills you want): copy any skills// folder into your project's .claude/skills/ directory (or ~/.claude/skills/ for all projects).

The one-file version: if you'd rather have the whole approach as passive guidance instead of commands, drop CLAUDE.md (Claude Code) or AGENTS.md (Codex and other AGENTS.md-reading agents) into your project root, or append it to your existing one.

Use in OpenAI Codex

The skills use the same SKILL.md format Codex reads natively, so no conversion is needed. Copy them into one of Codex's skill locations:

git clone https://github.com/Neeeophytee/finding-unknowns-skills<br>cp -r finding-unknowns-skills/skills/* ~/.agents/skills/ # all projects<br># or, per project: cp -r finding-unknowns-skills/skills/* your-repo/.agents/skills/

Codex detects skill changes automatically. For the passive-guidance version, drop AGENTS.md into your project root — Codex reads it before doing any work. Tested with Codex CLI v0.143: all 8 skills and their trigger descriptions load into the model-visible prompt (verifiable yourself with codex debug prompt-input). (Paths per the Codex skills docs.)

When to reach for which

New to a part of the codebase, or a whole domain → blindspot-pass

You'll know it when you see it (design, UX, tone) →...