proposal-readiness-check

Evaluate proposal.md against five readiness criteria before /spec review.

15|2|Updated Feb 12, 2026
One-click install
npx skills add https://github.com/kousukef/forge --skill proposal-readiness-check
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: proposal-readiness-check
Source: https://github.com/kousukef/forge/tree/main/skills/proposal-readiness-check
Command: npx skills add https://github.com/kousukef/forge --skill proposal-readiness-check

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Proposal Readiness Check ensures proposal.md is sufficiently prepared for /spec by validating five readiness criteria and prompting for missing information before /spec review.

Core Features & Use Cases

  • Defines five explicit readiness criteria: intent clarity, story specificity, scope boundaries, change size, and open questions.
  • Flags gaps and surfaces follow-up questions to keep /brainstorm and /spec aligned.
  • Use Case: After /brainstorm, confirm that proposal.md is ready for /spec to prevent escalations and low-quality specs.

Quick Start

Run the readiness check on proposal.md to verify that it meets the five criteria for /spec readiness.

Frequently Asked Questions about proposal-readiness-check

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

FAQPage Schema
How do I check if my proposal is ready for spec review?

To check proposal readiness for spec, evaluate the document against a five-criteria checklist covering intent clarity, story specificity, scope boundaries, change size, and open questions. This validation surfaces gaps and prompts for missing information before spec review.

What is proposal readiness validation in the brainstorm to spec transition?

Proposal readiness validation is a quality-check process during the brainstorm to spec transition. It applies five readiness criteria to proposal.md to ensure inputs are complete, preventing escalations and low-quality specs during the spec phase.

How do I identify open questions and scope gaps before writing a spec?

To identify open questions and scope gaps before writing a spec, run a readability check that flags missing scope boundaries and unresolved queries. This surfaces follow-up questions to keep brainstorm and spec phases aligned.

What criteria should a proposal meet before moving to the spec phase?

A proposal should meet five criteria before moving to the spec phase: intent clarity, story specificity, scope boundaries, change size, and open questions. Meeting these ensures the proposal.md has sufficient detail for spec generation.

Does the proposal readiness check require any specific dependencies?

No, the proposal readiness check requires no dependencies or components. It operates directly on proposal.md to validate readiness for spec by enforcing the five criteria and surfacing gaps for user clarification.

When should I avoid using a proposal readiness checklist?

You should avoid using a proposal readiness checklist if your proposal.md is still in early brainstorming phases lacking basic intent. The check is designed for the brainstorm to spec transition to validate completeness, not to generate initial requirements.