skills.rest
sap-tutorials
sap-tutorialsOFFICIAL
Explore all skills by this author →
WebsiteGitHub

openspec-propose

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

7|2|Updated Apr 28, 2026
Search Tags:#spec-driven development#openspec#task generation#design documents#change proposal#cli workflow
One-click install
npx skills add https://github.com/sap-tutorials/tutorials-ims --skill openspec-propose-sap-tutorials
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: openspec-propose
Source: https://github.com/sap-tutorials/tutorials-ims/tree/main/.claude/skills/openspec-propose
Command: npx skills add https://github.com/sap-tutorials/tutorials-ims --skill openspec-propose-sap-tutorials

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Writing a full change proposal with design documents, specifications, and implementation tasks is slow and inconsistent. This Skill turns a short description of what you want to build into a complete, structured OpenSpec change ready for implementation. ## Core Features & Use Cases - One-Step Proposal Generation: Creates the change scaffold and all required artifacts (proposal.md, design.md, tasks.md) in a single workflow using the openspec CLI. - Dependency-Aware Artifact Creation: Reads the artifact build order from openspec status and generates each artifact only after its dependencies are complete. - Interactive Clarification: Asks open-ended questions when the request is unclear, and derives kebab-case change names automatically from natural-language descriptions. - Use Case: Describe "add user authentication" and receive a scaffolded change at openspec/changes/add-user-auth/ with proposal, design, and tasks files ready to implement via /opsx:apply. ## Quick Start Ask the assistant to propose a new change for the feature you want to build, describing it in one or two sentences.

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 in plain language and the Skill derives a kebab-case name, runs `openspec new change`, then generates proposal.md, design.md, and tasks.md in dependency order until the change is ready for implementation.

What artifacts does an OpenSpec proposal include?▼

A proposal typically 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 the openspec CLI installed?▼

Yes, the Skill depends on the openspec CLI for scaffolding changes, reading artifact status, and fetching per-artifact instructions. Without the CLI installed, the change directory and artifacts cannot be generated.

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 duplicating the existing change directory.

How do I implement the change after the proposal is created?▼

Once all required artifacts show status done, run `/opsx:apply` or ask the assistant to implement. The tasks.md file then drives the implementation step by step.

Related Skills

Explore More Software Engineering Skills→
AppsVortexAppsVortex
31

arn-code-create-issue

Create GitHub or Jira issues from natural language prompts.

Official
Advanced
jankneumannjankneumann
4

openspec-onboard

Guide users through the OpenSpec workflow cycle with CLI commands.

Community
Intermediate
andyzengmathandyzengmath
24

ql-brainstorm

Guide structured Socratic brainstorming sessions to produce approved design documents.

Community
Advanced
rezicsrezics
6

openspec-propose

Generate proposal.md, design.md, and tasks.md via the openspec CLI.

Official
Advanced