openspec-propose

Generate proposal, design, and tasks documents for openspec CLI changes.

3.5k|183|Updated Mar 6, 2024
One-click install
npx skills add https://github.com/Myriad-Dreamin/tinymist --skill openspec-propose-myriad-dreamin
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openspec-propose
Source: https://github.com/Myriad-Dreamin/tinymist/tree/main/.codex/skills/openspec-propose
Command: npx skills add https://github.com/Myriad-Dreamin/tinymist --skill openspec-propose-myriad-dreamin

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires openspec, and includes scripts (resource) components.

What problem does it solve?

The Skill addresses the need for a streamlined process to propose changes, generating all necessary artifacts in a single step, thus reducing the time and complexity of change proposal preparation.

Core Features & Use Cases

  • Integrated Change Proposal: Automatically generates a comprehensive change proposal with design, specs, and tasks.
  • Automated Artifacts: Generates proposal.md, design.md, and tasks.md in one go.
  • Compatibility: Designed for use with the openspec CLI.
  • Use Case: Ideal for quickly outlining a change and having all supporting documentation ready for implementation.

Quick Start

Use the openspec-propose skill to initiate a new change proposal with the command: /opsx: propose new-change "add-user-auth".

Frequently Asked Questions about openspec-propose

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

FAQPage Schema
How do I generate a change proposal with design and tasks documents?

To generate a change proposal, you use a command like `/opsx: propose new-change "add-user-auth"` to automatically generate proposal.md, design.md, and tasks.md in one step.

What is the best way to streamline code change proposal creation for automated documentation?

Streamlining change proposal creation involves generating integrated design, specifications, and task artifacts simultaneously, reducing preparation time and complexity for software development.

Do I need the openspec CLI to create structured proposal documents?

Yes, you need the openspec CLI because this proposal generation feature is designed for compatibility with it and depends on the openspec framework to handle structured documents.

Can I automatically generate specifications and task lists together with a design document?

Yes, you can automatically generate specifications and task lists together with a design document by initiating a single command that outputs all three artifacts at once.

What limitations should I expect when generating change proposal artifacts?

A key limitation is its strict dependency on the openspec CLI, meaning the generated proposal, design, and tasks markdown artifacts are tailored specifically for that environment and may lack external integration.