openspec-propose

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

Updated Jun 11, 2026
One-click install
npx skills add https://github.com/Marcel-Carrillo/ProyectosIA --skill openspec-propose-marcel-carrillo
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: openspec-propose
Source: https://github.com/Marcel-Carrillo/ProyectosIA/tree/main/.cursor/skills/openspec-propose
Command: npx skills add https://github.com/Marcel-Carrillo/ProyectosIA --skill openspec-propose-marcel-carrillo

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Turning a rough feature idea into a structured, implementation-ready change proposal normally requires manually writing proposals, design documents, and task lists. This Skill automates that entire flow through the OpenSpec CLI, producing all required artifacts in one step. ## Core Features & Use Cases - One-step change creation: Runs openspec new change and generates proposal.md, design.md, and tasks.md in dependency order using openspec status and openspec instructions. - Automated requirement enrichment: Spawns a subagent that applies an enrichment workflow to expand the user's raw description into a functional analysis before writing artifacts. - Optional Jira integration: Detects ticket keys like KAN-18, links them to the change, and transitions the ticket to "En curso" via the Atlassian REST API or MCP fallback. - Use Case: A developer says "add supplier order tracking" and receives a scaffolded change directory with a proposal, design, and a tasks.md following the project's mandatory steps (feature branch, tests, curl verification, PR), ready for /opsx:apply. ## Quick Start Ask the assistant to propose a new OpenSpec change for the feature you want to build, for example by describing the feature and letting it derive a kebab-case change name.

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 from a feature idea?▼

Describe what you want to build and the skill derives a kebab-case change name, runs `openspec new change`, then generates proposal.md, design.md, and tasks.md in dependency order. No manual scaffolding is needed.

What artifacts does an OpenSpec proposal include?▼

A complete proposal includes proposal.md (what and why), design.md (how), and tasks.md (implementation steps). The skill loops through artifacts reported by `openspec status` until all items in applyRequires are done.

Does openspec-propose integrate with Jira tickets?▼

Yes, it detects ticket keys matching KAN-<number> in the request, saves the key to a .jira file in the change directory, and transitions the ticket to "En curso" via the Atlassian REST API or an MCP fallback. It is skipped silently if no ticket is found.

What happens after the proposal artifacts are created?▼

Once all required artifacts show status done, the change is ready for implementation. You run `/opsx:apply` or ask the agent to implement, which executes the tasks defined in tasks.md.

Why does the skill require the openspec CLI installed?▼

All scaffolding, status checks, and artifact instructions come from openspec CLI commands such as `openspec new change` and `openspec instructions`. Without the CLI, the skill cannot resolve change directories or artifact templates.