# Openspec Propose

Propose a new OpenSpec change with all artifacts generated in one step.

- Repository: https://github.com/OpenVidu/openvidu (2141 stars)
- Category: Design
- License: MIT
- Last updated: 2026-10-30
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add OpenVidu/openvidu --skill openspec-propose -g -a claude-code -y`
Codex: `npx skills add OpenVidu/openvidu --skill openspec-propose -g -a codex -y`
Cursor: `npx skills add OpenVidu/openvidu --skill openspec-propose -g -a cursor -y`
Gemini CLI: `npx skills add OpenVidu/openvidu --skill openspec-propose -g -a gemini-cli -y`

## Description

Propose a new OpenSpec change with all artifacts generated in one step. Use when the user wants to quickly describe what they want to build and get a complete proposal with design, specs, and tasks ready for implementation. Also use when the user says "openspec propose" or "opsx propose".

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

Propose a new change - create the change and generate all artifacts in one step.

**Planning boundary**: This workflow creates planning artifacts only. The user request that selected or triggered this workflow authorizes planning only, even if it asks to build or fix something. Do not edit project code. After the planning artifacts are complete, stop. Do not start implementation in the same response, even if the initial request asks for it. Wait for a new user request after the artifacts are presented; then start the apply workflow.

I'll create a change with the artifacts your schema defines. With the default spec-driven schema that is:
- proposal.md (what & why)
- `specs/<capability-path>/spec.md` (what the system must do - a delta, not the main spec)
- design.md (how)
- tasks.md (implementation steps)

`<capability-path>` is the spec directory relative to `specs/` (for example, `user-auth` or `identity/user-auth`). Preserve an existing capability's full path and follow the project's established organization for new capabilities.

When the user is ready to implement, they must start the apply workflow explicitly.

---

The rest: https://github.com/OpenVidu/openvidu/blob/HEAD/openvidu-dashboard/.claude/skills/openspec-propose/SKILL.md