openspec-propose

Generate OpenSpec proposal, design, and tasks artifacts in dependency order.

Updated Nov 12, 2025
One-click install
npx skills add https://github.com/artagon/artagon-vscode-profiles --skill openspec-propose-artagon
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openspec-propose
Source: https://github.com/artagon/artagon-vscode-profiles/tree/main/agents/skills/openspec-propose
Command: npx skills add https://github.com/artagon/artagon-vscode-profiles --skill openspec-propose-artagon

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you quickly turn an idea into a complete, implementation-ready proposal with all required artifacts generated together.

Core Features & Use Cases

  • Change scaffolding: Creates a new OpenSpec change from a kebab-case name or derived description.
  • Auto-generated artifacts: Produces proposal, design, and tasks artifacts in dependency order until everything required for apply-ready is complete.
  • Guided clarifications: Asks for user input when context is missing or unclear, then continues generation.

Quick Start

Describe the change you want to build or fix, then run /opsx:propose to generate the proposal, design, and tasks artifacts in one step.

Frequently Asked Questions about openspec-propose

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate design and task artifacts for an OpenSpec change proposal?

To generate design and task artifacts for an OpenSpec change proposal, you provide a rough idea or kebab-case name, and the workflow automatically scaffolds the proposal, design, and tasks in dependency order until apply-ready.

What is the best way to turn a rough idea into an implementation-ready change proposal?

The best way to turn a rough idea into an implementation-ready change proposal is using a coordinated workflow that auto-generates required artifacts, queries status in JSON, and stops only when all apply-ready requirements are complete.

How does artifact generation handle missing context when creating a spec design?

Artifact generation handles missing context during spec design by asking for user clarifications when information is unclear, then continuing the dependency-aware creation of the remaining implementation tasks.

Do I need the OpenSpec CLI to create implementation tasks and proposal documents?

Yes, the workflow satisfies OpenSpec CLI requirements by creating a change, querying status and instructions in JSON, and writing artifacts from templates to ensure the output is fully apply-ready.

Can I scaffold a new OpenSpec change from a descriptive text instead of a specific name?

Yes, you can scaffold a new OpenSpec change from a descriptive text, as the system derives the required kebab-case name from your description to begin generating the proposal artifacts.

What are the limitations of automated proposal generation for task planning?

Automated proposal generation for task planning is limited to producing artifacts in dependency order until apply-ready requirements are met, stopping without executing the actual implementation or deployment phases.