openspec-propose

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

1|Updated Apr 9, 2025
One-click install
npx skills add https://github.com/tbdavid2019/stockbot --skill openspec-propose-tbdavid2019
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: openspec-propose
Source: https://github.com/tbdavid2019/stockbot/tree/main/.opencode/skills/openspec-propose
Command: npx skills add https://github.com/tbdavid2019/stockbot --skill openspec-propose-tbdavid2019

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Turning a rough feature idea into a structured, reviewable implementation plan requires writing proposals, spec deltas, design documents, and task lists by hand. This Skill automates that entire planning phase through the OpenSpec CLI, producing all required artifacts in one guided workflow. ## Core Features & Use Cases - One-Step Change Creation: Derives a kebab-case change name from your description and scaffolds the change directory via openspec new change. - Dependency-Aware Artifact Generation: Uses openspec status and openspec instructions to build proposal.md, spec deltas, design.md, and tasks.md in the correct dependency order. - Planning-Only Boundary: Strictly creates planning artifacts without touching project code, then hands off to a separate apply workflow for implementation. - Use Case: Describe "add user authentication with OAuth" and receive a complete change folder containing the proposal, spec deltas for the auth capability, a design document, and an ordered task list ready for review. ## Quick Start Ask the assistant to propose a new OpenSpec change for the feature you want to build, describing what it should do.

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, then generates proposal.md, spec deltas, design.md, and tasks.md in dependency order using the OpenSpec CLI.

What artifacts does an OpenSpec proposal include?▼

With the default spec-driven schema it creates proposal.md describing what and why, spec delta files under specs/<capability-path>/, design.md explaining how, and tasks.md listing implementation steps.

Does openspec-propose implement the code changes too?▼

No. It operates under a strict planning boundary and only creates planning artifacts. Implementation happens in a separate apply workflow that you must explicitly request after reviewing the artifacts.

What happens if OpenSpec is not initialized in my project?▼

The skill runs openspec context first; if no OpenSpec root is found it stops and offers openspec init, waiting for your confirmation before creating any files or changes.

Can I use a different workflow schema for my proposal?▼

Yes, but only if you explicitly request a schema by name. The skill then passes --schema to openspec new change; otherwise it uses the configured default schema.