skills.rest
gqcn
gqcnCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

openspec-propose

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

13|3|Updated Mar 13, 2026
Search Tags:#design document#task planning#spec-driven development#openspec#cli automation#change proposal
One-click install
npx skills add https://github.com/gqcn/lina --skill openspec-propose-gqcn
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: openspec-propose
Source: https://github.com/gqcn/lina/tree/main/.agents/skills/openspec-propose
Command: npx skills add https://github.com/gqcn/lina --skill openspec-propose-gqcn

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Creating a structured change proposal normally requires manually drafting a proposal, design document, and task list across multiple files. This Skill automates the entire OpenSpec proposal workflow, generating all required artifacts in one step from a simple description of what you want to build. ## 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. - Dependency-Aware Artifact Creation: Reads the artifact build order from openspec status and generates each artifact only after its dependencies are complete. - Interactive Clarification: Asks the user open-ended questions when the change intent or context is unclear, and derives kebab-case change names automatically. - Use Case: A developer says "add user authentication" and receives a complete openspec/changes/add-user-auth/ change with proposal, design, and implementation tasks ready for execution. ## Quick Start Ask the assistant to propose a new change for adding user authentication and it will scaffold the change and generate all artifacts.

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 name, runs `openspec new change`, then generates proposal.md, design.md, and tasks.md in dependency order. All artifacts needed before implementation are created in one pass.

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 applyRequires field reported by `openspec status`.

Does openspec-propose require the openspec CLI?▼

Yes, the skill requires the openspec CLI to be installed. It shells out to commands like `openspec new change`, `openspec status --json`, 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. It does not overwrite or duplicate an existing change directory without confirmation.

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

Once all apply-required artifacts show done status, run the apply workflow (for example /opsx:apply) or ask the assistant to implement the tasks. The proposal artifacts serve as the specification for implementation.

Related Skills

Explore More Software Engineering Skills→
lllyyslllyys
27

triage

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

Community
Advanced
UnterrainerInformatikUnterrainerInformatik

openspec-archive-change

Archives completed OpenSpec changes after verifying artifact and task completion.

Official
Intermediate
RuixeWolfRuixeWolf
4

openspec-explore

Explores ideas and investigates codebases to clarify requirements before creating OpenSpec change proposals.

Community
Intermediate
juanjo-zurichjuanjo-zurich

sdd-spec

Writes delta specifications with RFC 2119 requirements and Given/When/Then scenarios.

Community
Advanced