skills.rest
thewoolleyman
thewoolleymanCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

openspec-propose

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

Updated Jan 31, 2026
Search Tags:#workflow#specification#cli#task planning#openspec#design documents#change proposal
One-click install
npx skills add https://github.com/thewoolleyman/personal-knowledge-base --skill openspec-propose-thewoolleyman
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: openspec-propose
Source: https://github.com/thewoolleyman/personal-knowledge-base/tree/main/.claude/skills/openspec-propose
Command: npx skills add https://github.com/thewoolleyman/personal-knowledge-base --skill openspec-propose-thewoolleyman

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Drafting a structured change proposal with design documents, specifications, and implementation tasks requires coordinating multiple artifacts in the right order, which is tedious and error-prone when done manually. ## Core Features & Use Cases - One-Step Proposal Generation: Creates a change directory and generates all required artifacts (proposal.md, design.md, tasks.md) in a single workflow. - Dependency-Aware Artifact Creation: Uses the openspec CLI to determine artifact build order and reads completed dependencies for context before writing new ones. - Interactive Clarification: Asks the user open-ended questions when the change description or context is unclear, deriving kebab-case change names automatically. - Use Case: A developer describes "add user authentication" and receives 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 by describing what you want to build, for example: propose a change to add OAuth login support.

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?▼

Describe what you want to build and the skill derives a kebab-case change name, runs openspec new change to scaffold the directory, then generates proposal.md, design.md, and tasks.md in dependency order.

What artifacts does an OpenSpec proposal include?▼

A proposal typically 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 applyRequires field reported by openspec status.

Does openspec-propose require the openspec CLI installed?▼

Yes, the skill requires the openspec CLI to be available. It shells out to commands like openspec new change, openspec status, and openspec instructions to scaffold and track 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 apply-readiness by checking that every artifact in applyRequires is complete.

Related Skills

Explore More Software Engineering Skills→
lllyyslllyys
27

triage

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

Community
Advanced
jankneumannjankneumann
4

openspec-onboard

Guide users through the OpenSpec workflow cycle with CLI commands.

Community
Intermediate
cpp-for-everythingcpp-for-everything
1

brainstorming

Guide teams from ideas to formal design specs through structured brainstorming and review rounds.

Official
Advanced
striderZAstriderZA
72

quick-design

Generate lightweight design specifications for small game changes with acceptance criteria.

Community
Intermediate