evidence-gap-detector

Files (2)

• SKILL.md
• openai.yaml · agents/

SKILL.md (first lines)

# Evidence Gap Detector

## Goal

Expose the minimum set of unknowns that materially weaken a proposal and turn them into verification targets.

The job of this skill is not to reject everything. The job is to separate what is known, inferred, assumed, and missing so the next decision is anchored in reality rather than confidence theater.

This skill diagnoses evidence quality. It does not replace the broader proceed/revise verdict from `quality-gate`, and it does not replace problem framing where the core claim is still vague.

## Default Posture

- evidence before certainty
- material unknowns before minor unknowns
- verification targets before argument
- weak signals are not proof
- name what would change the decision

## When To Use

Run this skill when:

- an idea or plan sounds stronger than its evidence base
- the team is moving from reasoning into action
- a proposal depends on several assumptions
- the user is confident but the proof chain is thin
- the next step should be chosen by what must be verified first

This is a strong checkpoint before:

- implementation
- prioritization
- validation design
- architecture commitment
- a `quality-gate` proceed decision

## Scope Boundaries

In scope:

- distinguish knowns from inferences and assumptions
- find missing facts that materially affect the decision
- rank evidence gaps by impact
- state what must be checked next

Out of scope by default:

- deciding the final overall verdict alone
- proving the claim by external research automatically
- listing every possible unknown regardless of relevance
- treating all uncertainty as equally important

## Escalation Conditions

Pause and keep the output narrow when:

- the core claim itself is still too vague to assess
- the object really needs framing more than evidence analysis
- the list of gaps grows without changing the decision
- no gap can be tied to a concrete next check

If the evidence review stays diffuse after one pass, recommend returning to `jtbd`, `quality-gate`, or a narrower validation question.

## Evidence Workflow

1. State the object under review in one sentence.
2. Extract the key claims or implied beliefs.
3. Label each as:
   - `known`
   - `inferred`
   - `assumed`
   - `missing`
4. Identify which missing items would actually change the decision.
5. Rank the gaps by decision impact.
6. Convert the top gaps into concrete verification targets.
7. Recommend the smallest next evidence-building step.

## Core Questions

Use the minimum set needed:

- What is being asserted as true here?
- Which part is actually evidenced?
- Which part is being inferred from weak signals?
- Which assumptions are carrying the proposal?
- What missing fact would change the decision most?
- What is the fastest way to reduce that uncertainty?

## Output Contract

Always return:

1. `object_under_review`
2. `key_claims`
3. `evidence_map`
4. `material_gaps`
5. `gap_priority`
6. `decision_sensitivity`
7. `verification_targets`
8. `confidence_status` (`grounded`, `partly-grounded`, `speculative`)
9. `recommended_followup` (`validation-designer`, `quality-gate`, `jtbd`, `selector`, `research`, `execution`)
10. `next_check`

## Good Evidence Signals

Strong signals:

- claims tied to observable facts or direct inputs
- assumptions named explicitly
- unknowns ranked by impact
- next check is concrete and small

Weak signals:

- high confidence with vague support
- key claims bundled together with no separation
- many unknowns listed with no prioritization
- the proposal proceeds as if missing evidence does not matter

From Alubiama/awesome-cognitive-skills, MIT.

More from Alubiama/awesome-cognitive-skills