Updated 4d ago
by marconae
speq-skill
A light-weight and straightforward workflow for spec-driven development with Claude Code and Codex. Written in Rust 🦀
55 GitHub stars (55)
+4 in 16 days
| Period | New stars |
|---|---|
| Oct 1 | 0 |
| Oct 2 | +1 |
| Oct 3 | +2 |
| Oct 4 | +2 |
| Oct 5 | 0 |
| Oct 6 | 0 |
| Oct 7 | 0 |
| Oct 8 | 0 |
| Oct 9 | 0 |
| Oct 10 | −1 |
| Oct 11 | 0 |
| Oct 12 | 0 |
| Oct 13 | 0 |
| Oct 14 | 0 |
| Oct 15 | 0 |
| Oct 16 | 0 |
- 19 skills (19 skills found in its SKILL.md files)
- 10 forks (10 forks)
- 4d ago last update (Last updated 4d ago)
Install
Skills CLI
npx skills add marconae/speq-skill
Asks which skills and agents to install. Just one: npx skills add marconae/speq-skill --skill speq-audit — add -g for every project.
Claude Code
git clone https://github.com/marconae/speq-skillcp -r "speq-skill/.claude/skills/speq-audit" ~/.claude/skills/
Copies the speq-audit skill into ~/.claude/skills/ for every project (use .claude/skills/ for one project). Repeat for the other skills listed below.
Plugin
/plugin marketplace add marconae/speq-skill
Run inside Claude Code if the repository ships a plugin marketplace, then pick plugins from /plugin.
Skills can run code on your machine — read the SKILL.md first.
What it does
In the author's own words, from each skill's SKILL.md.
-
speq-audit
Audit a speq project's health — spec-library structure, feature/decision-log/plan validation, ADR noise, mission-to-spec sync, unrecorded plans, and gitignore hygiene — then guide fixes. Use when the user asks to audit, health-check, doctor, lint, or sanity-check the specs or repo, or after cloning or inheriting a speq project.
.claude/skills/speq-audit/SKILL.md on GitHub (opens in a new tab) -
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.
.claude/skills/speq-cli/SKILL.md on GitHub (opens in a new tab) -
speq-code-guardrails
TDD cycle and code quality guardrails — failing-test-first, evidence, dependency, error-handling, and test-quality rules. Triggered by implementer-agent, implementer-expert-agent, and code-reviewer before any implementation or review work.
.claude/skills/speq-code-guardrails/SKILL.md on GitHub (opens in a new tab) -
speq-code-review
Code review tag taxonomy and findings output format — guardrail violations, dead code, test quality, bad comments, optimizations, YAGNI/over-engineering, error handling, and design depth. Triggered by code-reviewer.
.claude/skills/speq-code-review/SKILL.md on GitHub (opens in a new tab) -
speq-code-tools
Semantic code navigation and editing via Serena MCP — symbol-level tools required over grep/find/manual edits. Triggered by planner-agent, implementer-agent, implementer-expert-agent, code-reviewer, and recorder-agent.
.claude/skills/speq-code-tools/SKILL.md on GitHub (opens in a new tab) -
speq-design-philosophy
Complexity-management design principles — deep modules, information hiding and leakage, module boundaries, dependency direction, strategic vs. tactical tradeoffs. Triggered by planner-agent, plan-reviewer, implementer-agent, implementer-expert-agent, and code-reviewer before any design, implementation, or review work.
.claude/skills/speq-design-philosophy/SKILL.md on GitHub (opens in a new tab) -
speq-ext-research
External documentation and research via Context7 and WebSearch — library APIs and design patterns. Triggered by /speq-mission, planner-agent, implementer-agent, and implementer-expert-agent when current external sources are needed.
.claude/skills/speq-ext-research/SKILL.md on GitHub (opens in a new tab) -
speq-git-discipline
Read-only git guardrails and the Conventional Commits reference — no history writes, verify changes before completing. Triggered by planner-agent, implementer-agent, implementer-expert-agent, and recorder-agent. The headless orchestrators speq-plan-pr and speq-implement-pr are the sole exception. They write git history directly and use /speq-git-operations instead of this skill.
.claude/skills/speq-git-discipline/SKILL.md on GitHub (opens in a new tab) -
speq-git-operations
The git/gh operation-to-command mapping, safety rules, and return formats — invoked directly by the headless orchestrators speq-plan-pr and speq-implement-pr, the only components permitted to write git history or touch a remote.
.claude/skills/speq-git-operations/SKILL.md on GitHub (opens in a new tab) -
speq-implement-pr
Headless follow-up to /speq-plan-pr. Continues a plan on its feat/plan-name branch and runs it end-to-end: implements via /speq-implement, bumps the version, commits and pushes, runs the real test suites, records only if green, then opens/updates the PR and marks it ready. Resumes from the PR Lifecycle checkpoint in the plan's tasks.md if a prior run was cut off mid-flight. Arg: plan name, PR num…
.claude/skills/speq-implement-pr/SKILL.md on GitHub (opens in a new tab) -
speq-implement
Orchestrate implementation of a reviewed plan: task breakdown, TDD sub-agents, code review, and verification report. Use when the user asks to implement, build, or execute a plan under specs/_plans/ — after /speq-plan, before /speq-record. Arg: <plan-name>.
.claude/skills/speq-implement/SKILL.md on GitHub (opens in a new tab) -
speq-mission
Create or update specs/mission.md through a Socratic interview; detects brownfield vs greenfield. Use when the user asks to bootstrap or initialize a speq project, write or revise the project mission, or when /speq-audit reports mission drift and seeds this skill with its findings.
.claude/skills/speq-mission/SKILL.md on GitHub (opens in a new tab) -
speq-plan-pr
Headless, non-interactive version of /speq-plan for CI or agent-driven runs. Plans a feature without a live interview, commits the result to a feat/plan-name branch, and opens a draft PR. If a decision genuinely needs a human, it persists the partial plan and open questions and asks in a PR comment instead of blocking. Arg: plan name, feature intent text, PR number, or branch name.
.claude/skills/speq-plan-pr/SKILL.md on GitHub (opens in a new tab) -
speq-plan-review
Adversarial plan-review method and challenge taxonomy — premortem framing, multi-axis challenge taxonomy, severity discipline, and findings output format. Triggered by plan-reviewer.
.claude/skills/speq-plan-review/SKILL.md on GitHub (opens in a new tab) -
speq-plan
Plan a feature or change through a clarifying interview, producing spec deltas, plan.md, and decision-log.md via planner-agent with adversarial review. Use when the user asks to plan, spec, design, or scope a new feature, a change or removal of existing behavior, a refactor, or a fix — before any implementation.
.claude/skills/speq-plan/SKILL.md on GitHub (opens in a new tab) -
speq-planning
Plan-authoring workflow — spec delta authoring, test mapping, plan.md/decision-log.md generation, expert-task tagging, headless escalation, and revision mode. Triggered by planner-agent.
.claude/skills/speq-planning/SKILL.md on GitHub (opens in a new tab) -
speq-record
Merge implemented spec deltas into the permanent specs library and archive the plan. Use when implementation is verified — after /speq-implement produces verification-report.md — or when the user asks to record, merge, or archive a finished plan. Arg: <plan-name>.
.claude/skills/speq-record/SKILL.md on GitHub (opens in a new tab) -
speq-spec-merge
Delta-merge procedure — DELTA marker semantics, library-organization thresholds, and ADR-promotion field mapping. Triggered by recorder-agent.
.claude/skills/speq-spec-merge/SKILL.md on GitHub (opens in a new tab) -
speq-writing-guardrails
Nine prose rules covering conclusion-first order, one idea per sentence, named actors, consistent names, plain explanations, no filler, neutral tone, current results only, and no em dashes. Triggered by /speq-mission, /speq-audit, /speq-implement, /speq-plan-pr, /speq-implement-pr, planner-agent, plan-reviewer, and recorder-agent.
.claude/skills/speq-writing-guardrails/SKILL.md on GitHub (opens in a new tab)
No skill matches that filter.
Review before you install
A skill is a set of instructions and scripts your agent will follow, and it can run code on your machine. Read the SKILL.md and any scripts first — this listing is not a security review.