Speq cli

Skill marconae/speq-skill/.claude/skills/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.From its SKILL.md

Install

npx -y skills add marconae/speq-skill --skill speq-cli

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

runs commandsInstructs the agent to run 7 commands, including `speq search query "<query>"` and 6 more.

SKILL.md

1.8 KB, 366 tokens by cl100k_base, as published. Nobody here has run it

speq CLI

Spec-driven development via the speq CLI. The spec CLI is installed locally and available in the path. Invoke via speq.

Search-First Rule

Never read full spec files without searching first.

Apply information foraging — search narrows the scent trail before committing context window 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

Example

Finding error handling scenarios:

# Search for related scenarios
speq search query "error handling validation"

# Get specific scenario
speq feature get "cli/validate/Validation fails on missing field"

# Validate structure
speq feature validate cli/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"

What ships with it

Read from the repository

Just SKILL.md. No reference files, no scripts.