skills.rest
thomasmartinsen
thomasmartinsenCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

openspec-propose

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

1|Updated May 19, 2026
Search Tags:#task planning#spec-driven development#openspec#design documents#cli automation#change proposal
One-click install
npx skills add https://github.com/thomasmartinsen/talks --skill openspec-propose-thomasmartinsen
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: openspec-propose
Source: https://github.com/thomasmartinsen/talks/tree/main/20260519%20-%20Agentic%20engineering/weather-app-demo/.claude/skills/openspec-propose
Command: npx skills add https://github.com/thomasmartinsen/talks --skill openspec-propose-thomasmartinsen

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 produces all required artifacts in one step. ## 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. - Schema-Driven Artifacts: Uses the openspec CLI's instructions and templates so every artifact follows the project's defined structure and rules. - Dependency-Aware Sequencing: Reads completed artifacts as context before creating dependent ones, and verifies apply-readiness via status checks. - Use Case: Describe "add user authentication" and receive a scaffolded change at openspec/changes/add-user-auth/ with a complete proposal, design, and task list ready for implementation. ## Quick Start Ask the assistant to propose a new change for adding user authentication using the openspec-propose skill.

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 in one step?▼

Describe what you want to build and the skill runs openspec new change, then generates each required artifact in dependency order using openspec instructions. It stops once all artifacts required before implementation are marked done.

What artifacts does an OpenSpec proposal include?▼

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

Does openspec-propose require the openspec CLI?▼

Yes, the skill depends on the openspec CLI being installed. It calls commands like openspec new change, openspec status, and openspec instructions to scaffold the change and retrieve artifact templates and rules.

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 instead of overwriting it. This prevents accidental duplication of change directories under openspec/changes.

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

Once all required artifacts are done, run the apply step such as /opsx:apply or ask the assistant to implement. The skill confirms apply-readiness by checking that every artifact in applyRequires has status done.

Related Skills

Explore More Software Engineering Skills→
lllyyslllyys
27

triage

Categorize software issues into bugs, features, duplicates, and needs-info.

Community
Advanced
bacocobacoco
67

openspec-change-implementation

Implement approved OpenSpec proposals by executing tasks and recording test evidence.

Community
Advanced
Arman-KudaibergenovArman-Kudaibergenov
151

openspec-proposal

Formalize requested changes into OpenSpec proposal, tasks, design, and spec delta documents.

Community
Intermediate
nevesbnevesb

quick-design

Draft lightweight design specs for small gameplay changes with acceptance criteria.

Community
Intermediate