Speq Skill
A spec-driven development agent skill for Claude Code and Codex that enables structured specification writing and validation.
marconae · AI review on file
Installation
Read the source and dependencies before running a command. Copying does not install or execute anything.
npx skills add marconae/speq-skillAbout this skill
speq-skill
A light-weight and straightforward system for spec-driven development with Claude Code and Codex
Getting Started • Why • How It Works • Documentation • Installation
Getting Started
curl -fsSL https://raw.githubusercontent.com/marconae/speq-skill/main/install.sh | bash
Then open Claude Code or Codex and type /speq:mission to start.
- Downloads a pre-built
speqbinary for your platform (Linux x86_64/ARM64, macOS Apple Silicon); other platforms fall back to a source build - If building from source: installs the Rust toolchain if missing (via rustup) and builds
speq - Provisions the embedding model (
snowflake-arctic-embed-xs) into~/.cache/speq/models/for semantic search - Installs the CLI to
~/.local/bin/speq - Installs plugin files to
~/.speq-skill/ - Registers
/speq:*skills for Claude Code and Codex when available - Registers the local Codex marketplace when the Codex CLI is available
To uninstall, see Installation — Uninstall.
Why I Built It
I want to leverage AI coding agents such as Claude Code and Codex as effective tools to write software.
There are many other spec-driven development tools out there: OpenSpec, BMAD, SpecKit...
...but I was missing the following:
- A system that