openspec-propose

Generates complete OpenSpec change proposals with design, specs, and task artifacts.

Updated Mar 17, 2026
One-click install
npx skills add https://github.com/beliciobcardoso/mcp-postgres --skill openspec-propose-beliciobcardoso
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: openspec-propose
Source: https://github.com/beliciobcardoso/mcp-postgres/tree/main/.qwen/skills/openspec-propose
Command: npx skills add https://github.com/beliciobcardoso/mcp-postgres --skill openspec-propose-beliciobcardoso

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Writing a full change proposal with design documents, specifications, and implementation tasks is slow and inconsistent. This Skill automates the entire OpenSpec proposal workflow so a single description of what you want to build becomes a structured, implementation-ready change. ## Core Features & Use Cases - One-Step Proposal Generation: Creates the change directory and generates proposal.md, design.md, and tasks.md artifacts in dependency order using the openspec CLI. - Schema-Driven Artifacts: Follows openspec instructions, templates, and dependency rules so every artifact conforms to the project's specification schema. - Interactive Clarification: Asks the user open-ended questions when the change intent is unclear, and derives kebab-case change names automatically. - Use Case: Describe "add user authentication" and receive a complete openspec/changes/add-user-auth/ directory with proposal, design, and tasks ready for implementation via /opsx:apply. ## Quick Start Ask the assistant to propose a new change by describing what you want to build, for example: propose a change to add rate limiting to the API.

Frequently Asked Questions about openspec-propose

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

FAQPage Schema
How do I create an OpenSpec change proposal automatically?▼

Describe what you want to build and the skill runs openspec new change to scaffold the directory, then generates proposal.md, design.md, and tasks.md in dependency order using openspec instructions and status commands.

What artifacts does an OpenSpec proposal include?▼

A typical proposal includes proposal.md describing what and why, design.md covering how, and tasks.md listing implementation steps. The exact set is determined by the schema's applyRequires field reported by openspec status.

Does openspec-propose require the openspec CLI installed?▼

Yes, the skill depends on the openspec CLI being available. It invokes commands like openspec new change, openspec status, and openspec instructions to scaffold and generate artifacts.

What happens if a change with the same name already exists?▼

The skill asks whether you want to continue the existing change or create a new one with a different name, rather than overwriting or failing silently.

How do I implement the change after the proposal is created?▼

Once all required artifacts show status done, run /opsx:apply or ask the assistant to implement. The skill verifies each artifact file exists before moving to the next one.