# Speq CLI

> Query specs via the speq CLI — semantic search, feature listing, structure validation. Use before reading any spec file; every speq orchestrator and sub-agent invokes this first for spec discovery, search, or validation.

- Skill: `marconae/speq-cli` (Agent Skill)
- Install (CLI): `npx skillmds@latest add marconae/speq-cli`
- Raw SKILL.md: https://api.skillmd.com/api/skills/marconae/speq-cli/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Product & Planning
- Author: marconae (https://skillmd.com/u/marconae)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/marconae/speq-cli

---


# speq CLI

The CLI is installed locally and on the path. Invoke via `speq`.

## Search-First Rule

**Never read full spec files without searching first.** Search narrows the target before you spend context budget.

## Command Reference

| Command | Purpose |
|---------|---------|
| `speq domain list` | List all domains |
| `speq feature list` | Tree view of all features |
| `speq feature list <domain>` | Features in a domain |
| `speq feature get <domain>/<feature>` | Full feature spec |
| `speq feature get "<domain>/<feature>/<scenario>"` | Single scenario |
| `speq search query "<query>"` | Semantic search |
| `speq feature validate` | Validate all specs |
| `speq feature validate <domain>/<feature>` | Validate single feature |

## Workflow

```
1. Search first
   speq search query "<relevant terms>"

2. Get specific content
   speq feature get "<domain>/<feature>/<scenario>"

3. Validate after changes
   speq feature validate
```

## Anti-Pattern

```
# Wrong: Loading entire spec files
cat specs/cli/validate/spec.md

# Right: Search and get specific
speq search query "validation"
speq feature get "cli/validate/Required field missing"
```