find-gaps

Reviews plans, acceptance criteria, and design mocks to surface and resolve missing specifications.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Most shipped bugs come from things never written down — missing error states, unverifiable criteria, unstated assumptions. This Skill systematically finds those gaps in plans, acceptance criteria, and design mocks before implementation, then works with you one question at a time to turn each gap into a concrete, testable artifact update. ## Core Features & Use Cases - Checklist-driven gap discovery: Walks dedicated checklists for plans (scope, rollback, observability, security), acceptance criteria (measurability, negative paths, edge cases), and design mocks (loading/empty/error states, content variance, accessibility). - Interactive gap-closing loop: Triages gaps into Blocker / Should-address / Nice-to-have, asks one question at a time, and writes each confirmed answer back into the source artifact as a new AC, plan section, or mock state spec. - Resolution log: Produces a session summary of closed and parked gaps with owners, suitable for PR descriptions or release notes. - Use Case: Before handing a feature spec to engineering, run this Skill to catch that the checkout flow has no payment-decline behavior, no rollback plan for the migration, and no empty state for the contacts list — then capture decisions for each. ## Quick Start Ask the assistant to find gaps in your plan, acceptance criteria, or design mocks and walk through the findings one question at a time.

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 a product spec before development?▼

Run a structured gap review that walks checklists for scope, failure modes, state models, and observability, then triage findings by severity. This Skill does that interactively, asking one question at a time and writing each decision back into the spec.

How to write testable acceptance criteria from vague requirements?▼

Convert each vague statement into Given/When/Then form with a single observable outcome, naming the actor, trigger, and specific UI or event behavior. Follow up on vague answers until a QA engineer could execute the criterion without asking questions.

What edge cases should design mocks cover?▼

Mocks should specify loading, empty, error, and permission states, plus content variance like very long strings, unicode, and zero/one/many items. Also cover keyboard focus, responsive breakpoints, and dark mode where relevant.

When should I use a gap review versus a pre-mortem?▼

A gap review targets what is absent from the written artifact — missing states, unmeasurable criteria, unstated assumptions. A pre-mortem imagines future failure causes. This Skill supports both but focuses on turning absences into written decisions.

What are the limitations of a conversational gap-finding review?▼

It depends on the user being empowered to make decisions; gaps needing other owners get parked explicitly. Very large structural problems, like an AC set describing three tangled features, require rewriting the artifact rather than Q&A.