find-gaps

Reviews plans, acceptance criteria, and design mocks to surface missing states and unverifiable criteria.

Updated May 18, 2024
One-click install
npx skills add https://github.com/joshhornby/dotfiles --skill find-gaps-joshhornby
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: find-gaps
Source: https://github.com/joshhornby/dotfiles/tree/main/.claude/skills/find-gaps
Command: npx skills add https://github.com/joshhornby/dotfiles --skill find-gaps-joshhornby

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Written artifacts like plans, acceptance criteria, and design mocks often ship with silent omissions — missing error states, unverifiable criteria, unstated assumptions — that turn into bugs and rework after implementation begins. This Skill adversarially reviews an existing artifact and closes those gaps before coding starts. ## Core Features & Use Cases - Checklist-driven gap discovery: Walks dedicated checklists for plans, acceptance criteria, and design mocks covering failure modes, edge cases, roles, accessibility, i18n, and observability. - Interactive gap-closing loop: Triages findings into Blocker / Should-address / Nice-to-have, then asks one question at a time and writes each confirmed answer back into the artifact as a new acceptance criterion, plan section, or mock state spec. - Resolution log output: Produces a session log of resolved and parked gaps with named owners, suitable for PR descriptions or release notes. - Use Case: Before handing a feature spec to engineers, run this Skill to catch that the contacts list has no empty state, the migration has no rollback path, and the 'fast' criterion has no measurable target — then capture the decisions directly into the document. ## Quick Start Ask the assistant to use the find-gaps skill to poke holes in your current plan, acceptance criteria, or design mock and write the confirmed decisions back into the document.

Frequently Asked Questions about find-gaps

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I find gaps in acceptance criteria before development?

Run an adversarial review that checks each criterion for measurability, precondition-trigger-outcome structure, negative paths, input edge cases, and non-functional targets. Vague words like 'fast' or 'seamless' are flagged and refined into testable statements through one question at a time.

How to review a design mock for missing UI states?

Walk a checklist covering loading, empty, error, offline, and permission states, plus content variance like long text, RTL, and zero-item lists. Each missing state is captured as a named spec with trigger, visual, behaviour, and exit so it is implementable without re-asking.

When should I use gap-finding versus story-splitting?

Use gap-finding when a written artifact exists and needs tightening. Use story-splitting when the work is too large, horizontal, or component-split and must be broken into independently valuable child stories first. If review reveals tangled stories, route back to splitting.

Can this review artifacts that are not written down yet?

No, it requires an existing artifact to inspect. For unresolved decisions with no document, use a specification or grill-me style skill to establish the artifact first, then run the gap review on the result.

What happens to the answers collected during a gap review?

Every confirmed answer is written back into the source artifact as a new acceptance criterion, plan paragraph, or mock state spec. A closing resolution log lists resolved and parked gaps with owners for the PR description or release notes.