discover-improve

Improve blueprint discovery scores through deterministic fixes and LLM-driven refinements.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Iteratively improve a blueprint's discover-confidence score by applying deterministic fixes + LLM-driven semantic fixes via a halt-loop (ralph-loop-style autonomous iteration). Mirrors /plan-improve but for blueprints.

Core Features & Use Cases

  • Deterministic Phase A fixes to clean prose (e.g., hedge words and loopholes) and mark missing/cited material.
  • Phase B LLM-driven refinements to address structural gaps, citation density, and plan alignment.
  • Integrated with the /discover-confidence scoring cycle to re-score after each iteration and continue until a target verdict is reached.
  • HALT-loop orchestration that enforces cycle rules, safety checks, and progress validation.

Quick Start

Invoke the skill with a blueprint slug to run automated deterministic fixes, then a halt-loop will apply iterative semantic fixes until the target verdict is reached.

Frequently Asked Questions about discover-improve

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

FAQPage Schema
How do I improve a blueprint's discovery score using automated fixes?

Improve a blueprint's discovery score by applying deterministic Phase A fixes to clean prose, followed by LLM-driven semantic Phase B refinements. The skill orchestrates a halt-loop that re-scores the blueprint after each iteration until the target verdict is reached.

What is a halt-loop orchestration for iterative blueprint improvement?

A halt-loop orchestration for iterative blueprint improvement is an autonomous cycle that enforces safety checks and progress validation. It repeatedly applies fixes and re-scores blueprints using the discover-confidence scorer until the desired quality verdict is achieved.

How do I fix hedge words and loopholes in my blueprint automatically?

Fix hedge words and loopholes in blueprints automatically using the scripts/apply_fixes.py Phase A deterministic fixes. This process cleans prose and marks missing or cited material before initiating LLM-driven semantic refinements for structural gaps.

Can I use LLM-driven semantic refinements to address structural gaps in blueprints?

You can use LLM-driven semantic refinements to address structural gaps, citation density, and plan alignment in blueprints. Phase B prompts produce final adjustments after deterministic fixes clean the prose, ensuring comprehensive quality assurance.

What are the limitations of deterministic fixes for blueprint quality assurance?

Deterministic fixes for blueprint quality assurance are limited to cleaning prose, removing hedge words, and marking missing material. They cannot resolve structural gaps or citation density issues, which require subsequent LLM-driven semantic refinements to achieve the target score.