Updated 1w ago
by marconae
speq-skill
A light-weight workflow for spec-driven development with Claude Code and Codex. Written in Rust 🦀
54 GitHub stars (54)
| 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 |
| Oct 17 | 0 |
| Oct 18 | 0 |
| Oct 19 | 0 |
| Oct 20 | 0 |
| Oct 21 | 0 |
| Oct 22 | 0 |
| Oct 23 | 0 |
| Oct 24 | 0 |
| Oct 25 | 0 |
| Oct 26 | 0 |
| Oct 27 | 0 |
| Oct 28 | 0 |
| Oct 29 | 0 |
| Oct 30 | 0 |
| Oct 31 | 0 |
| Nov 1 | 0 |
| Nov 2 | 0 |
| Nov 3 | −1 |
| Nov 4 | 0 |
| Nov 5 | 0 |
| Nov 6 | 0 |
- 20 skills (20 skills found in its SKILL.md files)
- 10 forks (10 forks)
- 1w ago last update (Last updated 1w 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-adr-rules — add -g for every project.
Claude Code
git clone https://github.com/marconae/speq-skillcp -r "speq-skill/.claude/skills/speq-adr-rules" ~/.claude/skills/
Copies the speq-adr-rules 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-adr-rules
When a decision becomes an ADR: the default is no, only durable decisions qualify, search first, one decision per ADR. Use inside a /speq-plan, /speq-record, or /speq-audit run.
.claude/skills/ on GitHub (opens in a new tab)speq-adr-rules/ SKILL.md -
speq-audit
Audits a speq project's health: specs, decision logs, plans, mission sync, unrecorded plans, and gitignore hygiene. Use when asked to audit, health-check, or check a project build with speq-skill.
.claude/skills/ on GitHub (opens in a new tab)speq-audit/ SKILL.md -
speq-cli
Queries specs via the speq CLI: list and read features, validate structure, run the absence check. Invoke first for any spec discovery or validation.
.claude/skills/ on GitHub (opens in a new tab)speq-cli/ SKILL.md -
speq-code-guardrails
TDD cycle and code quality guardrails for the implementer and reviewer agents during /speq-implement. Not for general coding.
.claude/skills/ on GitHub (opens in a new tab)speq-code-guardrails/ SKILL.md -
speq-code-review
Code review tag taxonomy and findings format for the code-reviewer agent during /speq-implement. Not for general code review.
.claude/skills/ on GitHub (opens in a new tab)speq-code-review/ SKILL.md -
speq-code-tools
Semantic code navigation and editing via Serena MCP, required over grep and manual edits. Used by speq agents like /speq-implement. Not for general coding.
.claude/skills/ on GitHub (opens in a new tab)speq-code-tools/ SKILL.md -
speq-design-philosophy
Complexity-management design principles (deep modules, information hiding, dependency direction) for speq agents like /speq-plan or /speq-implement. Not for general design work.
.claude/skills/ on GitHub (opens in a new tab)speq-design-philosophy/ SKILL.md -
speq-ext-library
Looks up current library documentation (APIs, method signatures, usage examples) through Context7 when it is installed. Use when a task depends on a library's current API, version-specific behavior, or setup.
.claude/skills/ on GitHub (opens in a new tab)speq-ext-library/ SKILL.md -
speq-git-discipline
Read-only git guardrails. No history writes, verify changes before completing. Used by speq agents. Not for general git work.
.claude/skills/ on GitHub (opens in a new tab)speq-git-discipline/ SKILL.md -
speq-git-operations
The git/gh operation-to-command mapping and return formats — invoked directly by /speq-plan-pr and /speq-implement-pr.
.claude/skills/ on GitHub (opens in a new tab)speq-git-operations/ SKILL.md -
speq-implement-pr
Builds a planned feature on its feat/plan-name branch as a follow-up to /speq-plan-pr: implements, bumps the version, runs the real test suites, records the specs if green, comments the verification, and marks the PR ready. Run again to resume. Arg: plan name, PR number, or branch name.
.claude/skills/ on GitHub (opens in a new tab)speq-implement-pr/ SKILL.md -
speq-implement
Implements a reviewed plan: task breakdown, TDD sub-agents, code review, and a verification report. Use to build or execute a plan under specs/_plans/, after /speq-plan and before /speq-record. Arg: plan-name.
.claude/skills/ on GitHub (opens in a new tab)speq-implement/ SKILL.md -
speq-mission
Creates or updates specs/mission.md and specs/architecture.md through an interview, for brownfield or greenfield projects. Use to bootstrap a speq project, revise the mission, or when /speq-audit reports mission drift.
.claude/skills/ on GitHub (opens in a new tab)speq-mission/ SKILL.md -
speq-plan-pr
Plans a feature through the same clarifying interview as /speq-plan, then creates the feat/plan-name branch, commits the plan, and opens a draft pull request. Arg: feature intent text, plan name, PR number, or branch name.
.claude/skills/ on GitHub (opens in a new tab)speq-plan-pr/ SKILL.md -
speq-plan-review
Adversarial plan-review method: challenge taxonomy, severity rules, and findings format. Used by the plan-reviewer agent when reviewing a plan.
.claude/skills/ on GitHub (opens in a new tab)speq-plan-review/ SKILL.md -
speq-plan
Plans a feature or change through a clarifying interview, producing spec deltas, plan.md, and decision-log.md with adversarial review. Use to plan, spec, design, or scope a feature, change, removal, refactor, or fix, before any implementation.
.claude/skills/ on GitHub (opens in a new tab)speq-plan/ SKILL.md -
speq-planning
Plan-authoring workflow for the planner-agent: spec deltas, test mapping, plan.md, decision-log.md, expert tagging, and revision mode.
.claude/skills/ on GitHub (opens in a new tab)speq-planning/ SKILL.md -
speq-record
Merges implemented spec deltas into the permanent specs and archives the plan. Use after /speq-implement, or to record, merge, or archive a finished plan. Arg: plan-name.
.claude/skills/ on GitHub (opens in a new tab)speq-record/ SKILL.md -
speq-spec-merge
Delta-merge procedure — DELTA marker semantics, library-organization thresholds, and ADR-promotion field mapping. Used by /speq-record when recording a plan's deltas.
.claude/skills/ on GitHub (opens in a new tab)speq-spec-merge/ SKILL.md -
speq-writing-guardrails
Nine prose rules for speq artifacts and PR text: conclusion first, one idea per sentence, named actors, plain words, no filler, no em dashes. Not for general writing.
.claude/skills/ on GitHub (opens in a new tab)speq-writing-guardrails/ SKILL.md
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.
Similar skills
-
claude-code-best-practiceby shanraisshan from vibe coding to agentic engineering - practice makes claude perfect
-
SkillSpectorby NVIDIA Security scanner for AI agent skills. Detect vulnerabilities, malicious patterns, security risks, prompt injection, data exfiltration, and…
-
eigentby eigent-ai Eigent: The Open Source Cowork Desktop - Local and Free Alternative to Claude Cowork and Codex
-
-
awesome-design-skillsby bergside List of 67 awesome DESIGN.md and SKILL.md design skill files for agentic tools like Claude Design, Google Stitch, Codex, Cursor, and other…
-
qualitylayerby maxritter Plan, build and review software with your coding agents. Work side by side in the App or browser, or use your favourite terminal or IDE.