openspec-propose

Scaffold a change directory and generate proposal, design, and tasks artifacts.

6|2|Updated Feb 10, 2026
One-click install
npx skills add https://github.com/LingoJack/jcli --skill openspec-propose-lingojack
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openspec-propose
Source: https://github.com/LingoJack/jcli/tree/main/.github/skills/openspec-propose
Command: npx skills add https://github.com/LingoJack/jcli --skill openspec-propose-lingojack

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It solves the problem of turning a rough idea into a complete, implementation-ready plan with proposal, design, and task artifacts without manually coordinating multiple steps.

Core Features & Use Cases

  • One-step change proposal creation: Generates a change directory scaffold and produces proposal.md, design.md, and tasks.md in sequence.
  • Dependency-aware artifact generation: Uses openspec status and instructions to determine build order, reads completed dependencies for context, and stops when apply-ready artifacts are done.
  • Clarify when input is missing: Asks the user what they want to build when the change name or intent is unclear, then continues to generate artifacts.

Quick Start

Run openspec-propose and describe what change you want to build or fix so it can generate the complete proposal, design, and tasks.

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 software change proposal with design and task artifacts in one step?

To generate a software change proposal in one step, you describe your rough idea and the system scaffolds a change directory, producing proposal.md, design.md, and tasks.md sequentially for later execution.

What is an automated change proposal scaffold and when do I need one?

An automated change proposal scaffold is a generated directory structure containing proposal, design, and task artifacts. You need one when turning a rough software idea into an implementation-ready plan without manually coordinating multiple steps.

How does dependency-aware artifact generation work for implementation planning?

Dependency-aware artifact generation reads openspec status and instructions JSON to determine build order, checks completed dependencies for context, and stops generation once apply-ready artifacts are finished.

Can I generate implementation tasks automatically if my change intent is unclear?

If your change intent is unclear, the system will ask you to clarify what you want to build before continuing. Once you provide the change name and intent, it generates the complete proposal, design, and tasks artifacts.

What is the best way to prepare an implementation plan for apply-ready execution?

The best way to prepare an implementation plan is to scaffold a change directory that generates proposal, design, and tasks artifacts in sequence, fulfilling readiness gating for apply execution.

Do I need any external dependencies to automate task planning and proposal generation?

No external dependencies are required to automate task planning and proposal generation. The system operates independently to scaffold your change directory and generate the required markdown artifacts.