spec-revise

Edit specific proposal.md sections and re-emit the HARD GATE for validation.

9|Updated May 27, 2026
One-click install
npx skills add https://github.com/kamioj/spec-workflow --skill spec-revise
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spec-revise
Source: https://github.com/kamioj/spec-workflow/tree/main/codex/skills/spec-revise
Command: npx skills add https://github.com/kamioj/spec-workflow --skill spec-revise

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill simplifies the process of revising specific sections within a proposal.md file, ensuring that changes are made accurately and quickly.

Core Features & Use Cases

  • Selective Editing: Allows users to edit targeted sections like 'Why', 'What', 'How', or 'Risk' within a proposal.
  • Re-emission of HARD GATE: Ensures that any revision must pass through the HARD GATE again for validation.
  • Single Section Edits: Ideal for making minor adjustments without needing a full proposal rewrite.

Quick Start

Run the $spec-revise command followed by the section you wish to edit, e.g., $spec-revise why.

Frequently Asked Questions about spec-revise

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

FAQPage Schema
How do I edit specific sections of a proposal.md file without rewriting the entire document?

You can revise specific sections of a proposal.md file by targeting individual parts like 'Why', 'What', 'How', or 'Risk'. This selective editing approach allows iterative refinement without needing a full proposal rewrite.

How does proposal editing validate changes during iterative refinement?

Proposal editing validates changes by re-emitting the HARD GATE for validation after each section revision. This ensures any modifications made to the proposal.md file must pass through the validation process again before being accepted.

Can I update only the risk section in a markdown proposal while maintaining document validation?

Yes, you can update only the risk section in a markdown proposal while maintaining document validation. The revision process targets specific sections for single section edits and automatically re-emits the HARD GATE to validate the updated content.

What is the best way to handle iterative proposal refinement in a spec-workflow ecosystem?

The best way to handle iterative proposal refinement in a spec-workflow ecosystem is using section-targeted editing. This approach allows you to make minor adjustments to specific proposal.md sections while enforcing validation through the HARD GATE mechanism.

Does proposal section editing require any external dependencies or version control integrations?

Proposal section editing requires no external dependencies or version control integrations. It relies solely on file manipulation and conditional logic for section targeting within the proposal.md file, making it self-contained.