LightSpec Skill

LightSpec is a CLI tool that brings spec‑driven development to any AI‑assisted workflow. It helps you create feature specifications, track changes, and implement code based on those specs. This skill teaches your OpenClaw agent how to install, verify, update, uninstall, and use LightSpec effectively.

For more details on LightSpec, visit the Lightspec repository

Installation

LightSpec requires Node.js (v18 or later). The agent can install it globally via npm:

CODEBLOCK0

If Node.js is not present, the agent should first install Node.js (platform‑specific instructions can be provided if needed).

Verification

To confirm LightSpec is installed correctly, run:

CODEBLOCK1

The agent should expect a version number like 1.2.3. If the command fails, installation should be retried or the user notified.

Updating

To update LightSpec to the latest version:

CODEBLOCK2

After updating, verify again with lightspec --version.

Uninstalling

To remove LightSpec completely:

CODEBLOCK3

Basic Usage

All LightSpec commands follow the pattern:

CODEBLOCK4

Initialize a Project

Run inside a project directory to set up LightSpec:

CODEBLOCK5

This creates a lightspec/ folder and injects instructions into AGENTS.md (if present). The agent can then use the generated structure.

Create a New Feature Spec

CODEBLOCK6

Or using the spec subcommand (depending on version). The agent should inspect the output to see where the spec file was created (usually lightspec/changes/<change-name>/spec.md).

List Existing Changes or Specs

CODEBLOCK7

View Interactive Dashboard

CODEBLOCK8

The agent can run this to get a high‑level overview of all changes and specs.

Validate a Spec or Change

CODEBLOCK9

Checks for completeness and consistency.

Apply a Change (Implement)

After a spec is approved, the agent can apply it to the codebase:

CODEBLOCK10

This command generates code or updates files based on the spec (implementation details depend on the project’s configuration).

Show Details of a Change or Spec

CODEBLOCK11

Workflow Example

1. 1. Initialize project (if not already done)

1. 2. Create a change proposal

1. 3. Read the generated spec

1. 4. Ask the user what’s missing

1. 5. Validate the spec

1. 6. Implement after approval

Tips for the Agent

• - Always confirm with the user before running commands that change files (e.g., apply, init in an existing project).
• Use lightspec --help or lightspec help [command] if you need more details about a subcommand.
• LightSpec respects .lightspec/config.json for custom paths – the agent can read that to understand project‑specific settings.
• Refer to the official LightSpec documentation for the most updated information, guidence and how to guide the user.

ClawHub Installation

To install this skill from ClawHub, the user can run:

CODEBLOCK16

Once installed, the agent will automatically load this skill and be able to assist with LightSpec tasks.