openspec-proposal-creation

Community

Create structured spec proposals with deltas.

AuthorMichael0520
Version1.0.0
Installs0

System Documentation

What problem does it solve?

This skill helps teams plan and formalize feature changes by generating structured spec proposals with accompanying delta documentation.

Core Features & Use Cases

  • Generate a complete change proposal package including proposal.md, tasks.md, and spec-delta.md
  • Scaffold the change directory structure under spec/changes/{change-id}/ with clear naming and templates
  • Produce delta documents in ADDED/MODIFIED/REMOVED sections using the EARS format
  • Provide a ready-to-run Quick Start guide and validation guidance for end-to-end workflow

Quick Start

Describe a simple, repeatable workflow to create a new spec proposal:

  • Generate a unique change ID (e.g., add-feature-auth)
  • Create the directory structure: mkdir -p spec/changes/{change-id}/specs/{capability}
  • Populate proposal.md, tasks.md, and spec-delta.md using the included templates
  • Fill out the proposal and deltas following the guidelines, including at least one ADDED and one SCENARIO
  • Run the pre-submit validation steps to ensure structure and content correctness

Dependency Matrix

Required Modules

None required

Components

Standard package

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: openspec-proposal-creation
Download link: https://github.com/Michael0520/milo.me/archive/main.zip#openspec-proposal-creation

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 223,000+ vetted skills library on demand.