openspec-propose

Generates complete OpenSpec change proposals with design, specs, and task artifacts.

1|Updated Jun 6, 2026
One-click install
npx skills add https://github.com/JaimeHoracio/Ostacky --skill openspec-propose-jaimehoracio
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: openspec-propose
Source: https://github.com/JaimeHoracio/Ostacky/tree/main/assets/skills/openspec-propose
Command: npx skills add https://github.com/JaimeHoracio/Ostacky --skill openspec-propose-jaimehoracio

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Writing a full change proposal by hand—proposal, design document, and task breakdown—takes significant effort before any code is written. This Skill automates that entire spec-driven planning phase by generating all required OpenSpec artifacts in one guided step. ## Core Features & Use Cases - One-Step Proposal Generation: Creates the change directory and generates proposal.md, design.md, and tasks.md in dependency order using the openspec CLI. - Memory-Aware Planning: Searches Engram (via MCP tools) for similar past changes so you can extend existing work instead of duplicating effort. - Dependency-Driven Artifact Creation: Reads openspec status and openspec instructions JSON output to build artifacts in the correct order until the change is ready for implementation. - Use Case: You describe "add user authentication" and the Skill scaffolds openspec/changes/add-user-auth/ with a complete proposal, design, and task list, ready to implement with /opsx-apply. ## Quick Start Ask the assistant to propose a new change for the feature you want to build, describing it in a sentence so it can generate the full OpenSpec proposal.

Frequently Asked Questions about openspec-propose

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

FAQPage Schema
How do I create an OpenSpec change proposal?▼

Describe what you want to build in natural language, and the Skill derives a kebab-case change name, runs `openspec new change`, then generates proposal.md, design.md, and tasks.md in dependency order using the openspec CLI.

What artifacts does an OpenSpec proposal include?▼

A complete proposal includes proposal.md (what and why), design.md (how), and tasks.md (implementation steps). The Skill reads `openspec status --json` to determine which artifacts are required before implementation and creates them in sequence.

Does openspec-propose require any external tools?▼

Yes, it requires the openspec CLI to scaffold changes and retrieve artifact instructions. It also uses Engram MCP tools (engram_mem_search) to check for similar past changes, though Engram is an MCP server, not a skill.

What happens if a change with the same name already exists?▼

The Skill asks whether you want to continue the existing change or create a new one. It does not overwrite or duplicate an existing change directory without your confirmation.

How do I implement the change after the proposal is created?▼

Once all required artifacts show status done, run `/opsx-apply` or ask the assistant to implement. The Skill confirms readiness by checking that every artifact in applyRequires is complete.