discover-plan-confidence

Score discovery plans against the M2 rubric with deterministic checks.

Updated May 13, 2026
One-click install
npx skills add https://github.com/usetheodev/theo-ui --skill discover-plan-confidence
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: discover-plan-confidence
Source: https://github.com/usetheodev/theo-ui/tree/main/.claude/skills/discover-plan-confidence
Command: npx skills add https://github.com/usetheodev/theo-ui --skill discover-plan-confidence

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pyyaml, and includes scripts (resource) components.

What problem does it solve?

This Skill scores a discovery plan produced by /discover-plan to assess structural quality using a deterministic M2 rubric, enabling fast gating of plans before execution.

Core Features & Use Cases

  • Deterministic evaluation of discovery plans against the M2 rubric (research coverage, reference citations, plan completeness, and structural risk).
  • Zero-LLM-score; fast feedback with clear hard caps and soft-cap guidance to decide whether a plan is shippable.
  • Use case: apply to a plan slug to obtain a structured score and verdict for governance.

Quick Start

Invoke the score on a valid discovery plan slug to obtain a structured result.

Frequently Asked Questions about discover-plan-confidence

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

FAQPage Schema
How do I score a discovery plan against a structural rubric?

You can score a discovery plan by running it through deterministic evaluators for research coverage, reference citations, plan completeness, and spec smells to generate a weighted final verdict.

What is deterministic plan gating for project execution?

Deterministic plan gating is the process of evaluating a plan's structural quality using zero-LLM checks to provide fast feedback and clear hard caps before allowing the plan to proceed to execution.

How does the M2 rubric evaluate research coverage and reference citations?

The M2 rubric evaluates research coverage and reference citations by running independent checks that assess structural completeness, returning a weighted score and detailed per-dimension JSON report.

Can I get a structured JSON score report for plan governance?

Yes, you can obtain a structured JSON score report containing the final_score, final_verdict, and per-dimension details by applying the scoring checks to a valid discovery plan slug.

Do I need specific dependencies to run deterministic checks on discovery plans?

You need the pyyaml dependency installed in your environment to run the Python scripts that execute the deterministic scoring checks and generate the final verdict.

Are there limitations to using zero-LLM scoring for plan completeness?

The zero-LLM scoring approach relies entirely on deterministic structural checks, meaning it cannot assess semantic nuances or logical validity outside the M2 rubric's defined hard caps and spec smell rules.