openspec-propose

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

6|7|Updated Jun 4, 2026
One-click install
npx skills add https://github.com/nodesource/nsolid-plugin --skill openspec-propose-nodesource
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: openspec-propose
Source: https://github.com/nodesource/nsolid-plugin/tree/main/.opencode/skills/openspec-propose
Command: npx skills add https://github.com/nodesource/nsolid-plugin --skill openspec-propose-nodesource

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 docs, and task lists. This Skill automates that entire flow through the OpenSpec CLI, producing all required artifacts in one pass. ## Core Features & Use Cases - One-Step Change Scaffolding: Creates a change directory and generates proposal.md, design.md, and tasks.md in dependency order. - Schema-Driven Artifacts: Reads OpenSpec instructions, templates, and dependency graphs so each artifact follows the correct structure. - Interactive Clarification: Asks the user for missing context and derives kebab-case change names from natural-language descriptions. - Use Case: Describe "add OAuth login support" and receive a complete change folder with proposal, design, and implementation tasks ready to execute. ## Quick Start Ask the assistant to propose a new change for the feature you want to build, describing it in a sentence.

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 in natural language, and the skill derives a kebab-case change name, runs openspec new change, and generates proposal.md, design.md, and tasks.md in dependency order.

What artifacts does an OpenSpec proposal include?▼

A typical change 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 any tools installed?▼

Yes, it requires the openspec CLI to be installed and available. The skill shells out to commands like openspec new, openspec status, and openspec instructions to scaffold and track 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, rather than overwriting or failing silently.

How do I implement the change after proposing it?▼

Once all required artifacts show status done, run /opsx-apply or ask the assistant to implement. The skill confirms readiness by checking that every artifact in applyRequires is complete.