skills.rest
081595
081595COMMUNITY
Explore all skills by this author →
GitHub

openspec-propose

Generate proposal.md, design.md, and tasks.md for codebase changes via openspec CLI.

Updated Feb 6, 2024
Search Tags:#automation#devops#scaffolding#tasks#openspec#proposal#change
One-click install
npx skills add https://github.com/081595/mynode --skill openspec-propose-081595
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: openspec-propose
Source: https://github.com/081595/mynode/tree/main/myproject/.github/skills/openspec-propose
Command: npx skills add https://github.com/081595/mynode --skill openspec-propose-081595

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill streamlines the creation of a new repository change by generating all required artifacts (proposal, design, and implementation tasks) so contributors can move from idea to implementation-ready work without manual scaffolding.

Core Features & Use Cases

  • One-step proposal generation: Creates a change scaffold and produces proposal.md, design.md, and tasks.md for a described change.
  • Dependency-aware artifact sequencing: Queries openspec status and instructions to generate artifacts in dependency order until the change is ready to apply.
  • Interactive clarification and progress tracking: Uses prompts to clarify unclear input and reports created artifacts, suitable for feature requests, bug fixes, and refactors.

Quick Start

Propose a new change named add-user-auth by describing the feature you want and request generation of proposal.md, design.md, and tasks.md.

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 and implementation tasks for a repository change?▼

To generate a change proposal, describe the requested codebase change and the tool scaffolds proposal.md, design.md, and tasks.md in dependency order. It queries openspec status and instructions to prepare apply-ready artifacts for implementation.

What is the best way to scaffold proposal.md, design.md, and tasks.md for a new feature?▼

Scaffolding proposal.md, design.md, and tasks.md is done in one step by providing a feature description. The tool applies dependency-aware artifact sequencing via the openspec CLI to ensure correct generation order until the change is ready to apply.

Does the openspec proposal generation work for bug fixes and refactoring tasks?▼

Yes, openspec proposal generation works for feature requests, bug fixes, and refactors. It uses interactive clarification prompts to resolve unclear input and reports created artifacts for the requested codebase change.

How does dependency-aware artifact sequencing work when preparing a change for implementation?▼

Dependency-aware artifact sequencing queries openspec status and instructions to generate required artifacts in the correct order. This ensures the change proposal, design, and tasks files are produced sequentially per applyRequires rules until ready to apply.

Can I automate repository change workflows to produce apply-ready artifacts without manual scaffolding?▼

Yes, you can automate repository change workflows by describing the change request. The tool generates all required artifacts via the openspec CLI, eliminating manual scaffolding and preparing the change for implementation.

Why does the change proposal generation ask for clarification during the scaffolding process?▼

The change proposal generation uses interactive clarification prompts to resolve unclear input when you describe a codebase change. This ensures the generated proposal.md, design.md, and tasks.md accurately reflect the requested feature or bug fix.

Related Skills

Explore More Software Engineering Skills→
CatsofsufferingCatsofsuffering
5

openspec-propose

Generate OpenSpec proposal, design, and task artifacts for implementation.

Community
Intermediate
huangjia2019huangjia2019
114

openspec-propose

Generate proposal.md, design.md, and tasks.md via OpenSpec CLI.

Community
Intermediate
contenido-wqcontenido-wq

openspec-propose

Generate proposal, design, and tasks artifacts from a change request.

Community
Intermediate
linaproailinaproai
147

openspec-propose

Generate proposal, design, and task artifacts via the openspec CLI.

Official
Advanced