OpenSpec for Openclaw

A powerful CLI tool for managing spec-driven development workflows that structures AI-assisted coding into trackable, artifact-led changes.

jcorrego
v1.0.0
Jan 30, 2026
0
4.9k
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install openspec

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install openspec 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?

OpenSpec is a robust framework designed to bring discipline and structure to AI-assisted development environments. By implementing a spec-driven methodology, it transforms vague requests into a rigorous lifecycle of proposals, specifications, technical designs, and task lists. This approach ensures that both developers and AI agents have a clear, shared understanding of requirements before a single line of code is written, which is a core value proposition of Openclaw Skills.

The tool operates on the principle of delta specs, allowing for iterative updates to system documentation without losing historical context. Whether you are building new features, performing complex refactors, or managing migrations, OpenSpec provides the scaffolding necessary for high-quality, verifiable code output through its customizable schemas and RFC-compliant requirement formats.

OpenSpec Use Cases

  • Planning and implementing complex features using AI agents with structured guidance.
  • Managing technical debt and refactoring through documented design decisions.
  • Creating a living source of truth for system behavior using Given/When/Then scenarios.
  • Automating the generation of implementation checklists to track development progress.
  • Standardizing development workflows across teams using custom Openclaw Skills schemas.

How OpenSpec Works

  1. Initialize the project using the CLI to set up the necessary directory structure and configuration.
  2. Create a new change folder to encapsulate the context and artifacts for a specific development task.
  3. Generate a proposal and detailed specifications using RFC 2119 keywords to define system behavior.
  4. Create a technical design and a granular task list to guide the implementation phase.
  5. Work through the generated tasks, marking them complete as the implementation progresses.
  6. Run validation checks to ensure all requirements are met before archiving the change to update the main project specs.

OpenSpec Setup

# Install the OpenSpec CLI globally via npm
npm install -g @fission-ai/openspec@latest

# Initialize OpenSpec in your local project directory
cd /path/to/project
openspec init --tools claude

# Keep the tool updated for the latest Openclaw Skills compatibility
openspec update

OpenSpec Data Schema & Taxonomy

OpenSpec maintains a structured directory within your project to ensure all artifacts are easily accessible and machine-readable.

Path Purpose
openspec/config.yaml Global configuration, including schemas, project context, and validation rules.
openspec/specs/ The definitive source of truth for the current system behavior.
openspec/changes/ Contains individual folders for active changes, each holding its own proposal, delta specs, and design docs.
openspec/schemas/ Custom workflow definitions that dictate the sequence and templates of artifacts.
tasks.md An implementation checklist generated within each change folder to track progress.

OpenSpec Advanced Features

  • Support for multiple development schemas including TDD-driven, rapid, and spec-driven workflows.
  • Delta specification logic that merges changes into the main source of truth only upon successful archiving.
  • Full JSON output support for all CLI commands, enabling seamless integration with AI agent toolchains.
  • Customizable validation rules to enforce specific documentation standards or rollback plans.
  • Extensible template system for generating consistent proposals and design documents across any Openclaw Skills implementation.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*