An autonomous, spec-driven development framework that uses the OpenSpec CLI and Claude Code to orchestrate the full software lifecycle from issue to pull request.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install openspec-workflow
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install openspec-workflow using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is OpenSpec Workflow?
The OpenSpec Workflow is a robust methodology designed to manage autonomous code changes through rigorous specification and automated review gates. Built for Openclaw Skills, it positions the AI agent as a high-level orchestrator that drafts technical artifacts and makes critical judgment calls, while delegating deep codebase exploration and implementation tasks to Claude Code. This separation of concerns ensures that every code change is grounded in technical truth, significantly reducing regressions and improving architectural consistency.
By following this workflow, developers can leverage Openclaw Skills to handle the heavy lifting of repository analysis and code generation while maintaining human-in-the-loop oversight. The process moves through a structured lifecycle—starting from a GitHub issue, progressing through a multi-stage artifact loop (Proposal, Design, Specs, and Tasks), and culminating in a verified pull request and automated spec synchronization.
OpenSpec Workflow Use Cases
- Implementing complex new features or product capabilities that require updated technical documentation.
- Executing large-scale refactors that change existing system behavior and require architectural validation.
- Managing breaking changes or migrations where traceability between requirements and code is critical.
- Standardizing the contribution process in Openclaw Skills enabled repositories through automated spec-driven PRs.
How OpenSpec Workflow Works
- Initialize the process by creating a new change directory using the OpenSpec CLI to track all related artifacts.
- Iterate through the artifact loop, drafting the proposal, design, and detailed specs while utilizing AI sub-agents for technical reviews.
- Delegate the implementation phase to Claude Code, providing it with the generated tasks.md and full repository context.
- Commit the changes and open a pull request using the GitHub CLI, ensuring the change name is correctly tagged in the PR body.
- Monitor and address PR review comments, utilizing the same artifact review logic to refine the code implementation.
- Merge the PR to trigger a GitHub Action that automatically archives the change and synchronizes the project specifications.
OpenSpec Workflow Setup
To get started with this workflow, ensure you have the necessary CLI tools installed and authenticated.
# Install the OpenSpec CLI
npm install -g @fission-ai/openspec
# Ensure Claude Code and GitHub CLI are installed and authenticated
# Then initialize OpenSpec in your repository root
openspec init
OpenSpec Workflow Data Schema & Taxonomy
The workflow organizes its data within an openspec/ directory at the repository root, ensuring a clean taxonomy of changes and specifications.
| Location | Content Type | Description |
|---|---|---|
openspec/changes/ |
Change Folders | Contains active and pending development work organized by kebab-case names. |
openspec/specs/ |
Global Specs | The source of truth for current system requirements and capabilities. |
.../proposal.md |
Artifact | High-level summary of the 'Why' and 'What' of the change. |
.../tasks.md |
Metadata | A structured checklist for Claude Code to track implementation progress. |
OpenSpec Workflow Advanced Features
- Context-aware review loops where AI agents verify artifact claims by performing live greps and file reads within the repository.
- Dynamic timeout management based on change size, allowing for complex multi-file implementations without process interruption.
- Seamless integration with GitHub Actions for auto-archiving, which automates branch cleanup and spec syncing upon PR merge.
- Support for PTY-based execution of Claude Code to handle interactive terminal requirements autonomously within Openclaw Skills environments.
SKILL.md
Loading
Related Openclaw Skills
Chart Splat
A robust API-driven charting tool that generates professional PNG visualizations from raw data via simple CLI commands or JSON configurations.
Feishu Probe Optimizer
A technical optimization skill designed to minimize Feishu API consumption by extending probe cache durations in OpenClaw.
Stock Daily Report Pro
A professional-grade A-share market report generator that produces detailed HTML and image-based technical analysis for personal research.
Chinese Font Renderer for Python Images
A professional solution for fixing garbled Chinese characters and emoji display issues in Python-generated images and charts.
Gmail
A comprehensive Gmail API integration for AI agents that provides managed OAuth authentication to read, send, and organize emails and threads.
Megasquirt ECU Tuner
A specialized tool for tuning and calibrating Megasquirt engine management systems via TunerStudio and automated MSQ file analysis.
Featured*
