git404hub

what is finding-unknowns-skills fr?

neeeophytee/finding-unknowns-skills — explained in plain English

Analysis updated 2026-05-18

240Audience · vibe coderComplexity · 1/5LicenseSetup · easy

tl;dr

A set of 8 installable AI agent skills that help you surface what you don't know about a task before you start building, so mistakes are cheaper to catch.

vibe map

mindmap
  root((finding-unknowns-skills))
    What it does
      Surfaces unknowns early
      8 agent skills
      Works before during after
    Tech stack
      Claude Code
      OpenAI Codex
      Kimi Code CLI
    Use cases
      Blindspot check
      Requirement interviews
      Pre merge quiz
    Audience
      Vibe coders
      AI agent users
    Setup
      npx skills add
      Claude Code plugin

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Run a blindspot check before starting work in an unfamiliar part of a codebase.

VIBE 2

Get interviewed one question at a time to clarify ambiguous requirements before building.

VIBE 3

Generate a plan that highlights the riskiest decisions first instead of burying them.

VIBE 4

Take a comprehension quiz before merging a change to catch things you missed.

what's the stack?

Claude CodeOpenAI CodexKimi Code CLI

how it stacks up fr

neeeophytee/finding-unknowns-skillsdasterprokio/awesome-ai-companionlcharvol/macsift
Stars240240240
LanguagePythonSwift
Setup difficultyeasyeasyeasy
Complexity1/51/52/5
Audiencevibe codervibe codergeneral

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · easy time til it works · 5min
Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

in plain english

finding-unknowns-skills is a set of 8 installable skills for AI coding assistants like Claude Code and OpenAI Codex, built around one idea: your prompt is like a map, and the real codebase is the territory it describes. The gap between what you wrote and what is actually true is your unknowns, and the earlier you surface them, the cheaper they are to fix. The project turns that idea, taken from a public essay by an Anthropic team member, into ready to use commands. The 8 skills are grouped by when you would use them. Before you start building, blindspot-pass looks for things you have not considered in an unfamiliar area, brainstorm-prototypes generates throwaway variations so you can react to options instead of describing taste you cannot put into words, interview-me asks you one question at a time starting with the ones most likely to change your architecture, reference-hunt searches for existing code that already solves your problem, and implementation-plan produces a plan that leads with your riskiest decisions. While building, implementation-notes logs every place you deviate from the plan. After building, pitch-packager bundles your spec, prototype, and notes into a document for reviewers, and change-quiz gives you a comprehension quiz to pass before merging. Installing is meant to be simple. A single command using Vercel's skills CLI auto-detects whichever agent you use, including Claude Code, Cursor, Codex, Copilot, and Gemini, and installs the skills in the right place for each. It can also be installed as a Claude Code plugin, copied manually into a project's skills folder, or added as a CLAUDE.md or AGENTS.md file for agents that read passive instructions instead of individual commands. The project also documents specific setup steps for Codex and for Kimi Code CLI. It is released under the MIT License, with credit given to the original essay the ideas are drawn from.

prompts (copy fr)

prompt 1
Install the finding-unknowns-skills package into my Claude Code project using npx skills add.
prompt 2
Run the blindspot-pass skill on this part of my codebase before I start making changes.
prompt 3
Use interview-me to ask me one question at a time about the feature I'm about to build.
prompt 4
Run implementation-plan on my current task and lead with the decisions I'm most likely to change.
prompt 5
Use change-quiz to test whether I understand my own changes before I merge them.

Frequently asked questions

what is finding-unknowns-skills fr?

A set of 8 installable AI agent skills that help you surface what you don't know about a task before you start building, so mistakes are cheaper to catch.

What license does finding-unknowns-skills use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is finding-unknowns-skills to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is finding-unknowns-skills for?

Mainly vibe coder.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.