openspec-authoring

What problem does it solve?

This Skill standardizes the creation and revision of OpenSpec documents, ensuring consistency, clarity, and adherence to established conventions. It eliminates ambiguity in proposals, tasks, and specification deltas, making documentation easier to read, review, and maintain.

Core Features & Use Cases

• Metadata & Frontmatter: Enforces inclusion of Change ID, Status, Date, and Author for proposals and tasks, and specific headers for specs.
• Required Section Ordering: Guides on the correct sequence of sections for proposal.md, tasks.md, and spec.md (delta).
• Requirement & Scenario Patterns: Defines how to structure requirements with Given/When/Then scenarios, ensuring testability and behavior-focused descriptions.
• Validation Checklist: Provides a checklist for self-validation, including checking referenced skills/agents and workspace-relative paths.
• Use Case: A product manager is drafting a new feature proposal. This skill guides them through structuring the proposal.md with an executive summary, goals, approach, and risks, ensuring all necessary information is present and well-organized for stakeholders.

Quick Start

Help me structure a new OpenSpec proposal for a feature, ensuring all required sections are present and in the correct order.