opsx-propose

Generates OpenSpec change proposals with design and task artifacts via slash command.

1|Updated Jun 27, 2026
One-click install
npx skills add https://github.com/TE-QuanBZhang/skills-pool --skill opsx-propose-te-quanbzhang
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: opsx-propose
Source: https://github.com/TE-QuanBZhang/skills-pool/tree/main/ai-coding/skills/opsx-propose
Command: npx skills add https://github.com/TE-QuanBZhang/skills-pool --skill opsx-propose-te-quanbzhang

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Starting a new change in an OpenSpec workflow requires manually creating the change scaffold and writing proposal, design, and task documents one by one, which slows down the planning phase of feature development. ## Core Features & Use Cases - One-Step Change Proposal: Creates a new OpenSpec change and generates proposal.md, design.md, and tasks.md artifacts in a single /opsx:propose invocation. - Codebase-Aware Planning: Uses CodeGraph exploration to ground the proposal in the existing codebase before generating artifacts. - Guided Artifact Generation: Follows the OpenSpec build order and per-artifact instructions so each document conforms to the expected structure. - Use Case: A developer wants to add a new authentication feature. They run /opsx:propose add-oauth-login, and the skill explores the codebase, creates the change, and produces the proposal, design, and task breakdown ready for review. ## Quick Start Ask the assistant to propose a new OpenSpec change by describing what you want to build, for example: propose a change to add OAuth login support.

Frequently Asked Questions about opsx-propose

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

FAQPage Schema
How do I propose a new change with OpenSpec?

Run the /opsx:propose slash command followed by a kebab-case change name or a description of what you want to build. The skill creates the change with openspec new change and generates proposal.md, design.md, and tasks.md in sequence.

What artifacts does an OpenSpec change proposal include?

A proposal includes three artifacts: proposal.md describing what and why, design.md describing how, and tasks.md listing implementation steps. The skill generates all three in one step following the OpenSpec build order.

Does opsx-propose require the openspec CLI?

Yes, the skill requires the openspec CLI to create changes, retrieve build order, and fetch per-artifact instructions. CodeGraph is optional but recommended for exploring the codebase before writing the proposal.

What happens if I run /opsx:propose without any input?

If no argument is provided, the skill asks what you want to build before proceeding. Once you describe the goal, it explores the codebase with CodeGraph and creates the change artifacts.

How does CodeGraph improve OpenSpec proposals?

CodeGraph exploration runs before change creation to surface relevant code context using key terms from your request. This grounds the generated proposal and design documents in the actual codebase structure.