OpenSpec CLI Guidelines

This skill provides instructions for using the openspec command-line interface (CLI) effectively within the MCP environment, where interactive prompts are not supported.

Core Principles

• Non-Interactive Mode: Always use flags that bypass interactive prompts.
• Explicit Targets: Specify exactly what to validate to avoid ambiguity.

Validation Commands

The default openspec validate command triggers an interactive mode which will cause the agent to hang or fail. Use the following explicit commands instead:

Validate All

To validate the entire project:

openspec validate --all

Validate Changes

To validate only the currently changed files (useful for quick checks):

openspec validate --changes

Validate Specifications

To validate only the specification files:

openspec validate --specs

Validate Specific Item

To validate a specific item by name:

openspec validate <item-name>