skills.rest
TE-QuanBZhang
TE-QuanBZhangCOMMUNITY
Explore all skills by this author →
GitHub

openspec-propose

Generates OpenSpec change proposals with design, specs, and tasks using CodeGraph codebase context.

1|Updated Jun 27, 2026
Search Tags:#design docs#task planning#openspec#codebase exploration#codegraph#change proposal#spec workflow
One-click install
npx skills add https://github.com/TE-QuanBZhang/skills-pool --skill openspec-propose-te-quanbzhang
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: openspec-propose
Source: https://github.com/TE-QuanBZhang/skills-pool/tree/main/ai-coding/skills/openspec-propose
Command: npx skills add https://github.com/TE-QuanBZhang/skills-pool --skill openspec-propose-te-quanbzhang

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Writing a complete change proposal with design documents, specs, and implementation tasks requires manually exploring the codebase and drafting multiple artifacts, which is slow and often disconnected from the actual code structure. ## Core Features & Use Cases - One-Step Artifact Generation: Creates proposal.md, design.md, and tasks.md in a single workflow driven by the OpenSpec CLI. - CodeGraph Codebase Exploration: Runs codegraph explore on key technical terms to ground artifacts in real files, call paths, and architecture patterns. - Dependency-Aware Sequencing: Reads openspec status JSON to build artifacts in dependency order until all apply-required artifacts are done. - Use Case: Describe a feature like "add user authentication" and receive a scaffolded change directory with a complete proposal, design, and task list ready for implementation via /opsx:apply. ## Quick Start Ask the assistant to propose a new change for the feature you want to build, for example by saying "propose a change to add user authentication".

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

Provide a change name in kebab-case or describe what you want to build, and the skill derives a name, scaffolds the change with openspec new change, then generates proposal.md, design.md, and tasks.md in dependency order.

How does CodeGraph improve OpenSpec proposals?▼

CodeGraph explore runs on key technical terms from your description to return relevant source symbols, call paths, and architecture patterns. These findings are incorporated into the proposal, design, and tasks artifacts so they reflect the actual codebase.

What tools are required to run openspec-propose?▼

The skill requires the OpenSpec CLI for change scaffolding, status checks, and artifact instructions. CodeGraph CLI is used for codebase exploration, but if it returns no meaningful results the workflow proceeds without it.

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, rather than overwriting or failing silently.

What artifacts must exist before implementation can start?▼

The skill reads the applyRequires array from openspec status JSON and loops through artifacts in dependency order until every required artifact has status done, after which you can run /opsx:apply to implement.

Related Skills

Explore More Software Engineering Skills→
kuchida1981kuchida1981

openspec-new-change

Create an OpenSpec change scaffold and display first artifact instructions.

Community
Intermediate
Gentleman-ProgrammingGentleman-Programming
1.3k

sdd-verify

Verify code changes against specs, design decisions, and task completion.

Official
Advanced
quaid-appquaid-app
3

openspec-archive-change

Archives completed openspec changes with artifact and task validation, preserving metadata in dated folders.

Official
Advanced
cosmicdreamscosmicdreams

jira

Manage Jira issues, transitions, comments, and sprint views via jira-cli.

Community
Intermediate