A light-weight and straightforward system for spec-driven development with Claude Code or OpenAI Codex. Written in Rust 🦀
Supply asset profile
Code review, repo analysis, testing, CI, GitHub, DevOps, and developer workflow skills.
Scenario
GitHub automation
I need my agent to triage GitHub issues, review pull requests, and summarize repository changes.
Agent fit
Claude Code + OpenAI Agents + CLI
Codex, Claude Code, Cursor, CLI, or custom agents.
Install
Ready
npx skills add marconae/speq-skill
Maintenance
fresh
Pushed today
Risk
Needs review
Low GitHub adoption signal
GitHub quality
48
75/100 quality · 78/100 trust
Coverage tags
Review notes
Low GitHub adoption signal · Quality score needs review
Agent adoption scorecard
These scores combine public repository metadata, OpenAgentSkill review signals, maintenance freshness, and install readiness. They are a shortlist signal, not a replacement for human review.
Quality
StrongSolid option that is likely worth shortlisting for production workflows.
Trust
Sandbox onlyUseful candidate with missing or mixed trust signals. Keep it in an isolated workspace until the outcome loop proves task fit.
Audit
Needs reviewInstall readiness, security metadata, maintenance, and adoption risk.
Trust Score v5
Run only in a sandbox and compare close alternatives before using it for real work.
Stars
48 GitHub stars
Repo activity
48 stars, 9 forks
Maintenance
Pushed today
License
MIT
Install
npx skills add marconae/speq-skill
Install safety
standard package or runtime install path
Permission surface
shell or command execution
Agent outcomes
No agent outcome data yet
Docs
Strong README/SKILL.md context
Risk summary
Install readiness
Agent-readable metadata
Use this block or the embedded JSON to decide whether an agent should install this skill, choose an alternative, or ask for human review first.
Suited tasks
Suited agents
Install decision
Trust and risk
Outcome loop
Do not use when
Alternative
164.7K stars
npx skills add mattpocock/skills --skill grill-with-docs
Alternative
168.6K stars
npx skills add mattpocock/skills --skill code-review
Alternative
164.7K stars
npx skills add mattpocock/skills --skill to-spec
Alternative
176.7K stars
npx skills add mattpocock/skills --skill to-tickets
Agent safety v2
Sparse or mixed signals. Useful for discovery, but not for autonomous installation.
Test manually in an isolated workspace and compare against safer alternatives.
high
Skill metadata references terminal, CLI, shell, subprocess, or command execution workflows.
medium
Skill likely fetches remote pages, APIs, repositories, or external services.
medium
Skill may read or write project files, documents, generated artifacts, or local workspace state.
Install targets
Copy the registry command or an agent-specific install prompt for Codex, Claude Code, and Cursor.
Use the registry command when your workflow supports the OpenAgentSkill installer.
$ npx skills add marconae/speq-skillAgent resolve plan
The Resolve API returns the selected skill, alternatives, safety policy, audit notes, install target, and copy-paste prompt an agent can follow without scraping this page.
Resolve JSON
/api/agent/resolve?task=Use%20Speq%20Skill%20for%20an%20agent%20workflow&agent=codex&max_risk=medium
Resolve text
/api/agent/resolve?task=Use%20Speq%20Skill%20for%20an%20agent%20workflow&agent=codex&max_risk=medium&format=text
Install handoff
/api/skills/marconae-speq-skill/install
Agent should check
Copy prompt
Task: Use Speq Skill in this workspace.
Resolve first: https://www.openagentskill.com/api/agent/resolve?task=Use%20Speq%20Skill%20for%20an%20agent%20workflow&agent=codex&max_risk=medium
Review install handoff: https://www.openagentskill.com/api/skills/marconae-speq-skill/install
Install command: npx skills add marconae/speq-skill
Before running it, summarize audit warnings, required permissions, and the fallback skill if install is risky.Agent handoff
Use the public install endpoint to fetch the command, safety checklist, target prompts, and canonical links for this skill.
Install handoff
/api/skills/marconae-speq-skill/install
LLM text format
/api/skills/marconae-speq-skill/install?format=text
Find alternatives
/api/skills/search?q=Speq%20Skill&limit=3
Agent prompt
Use Speq Skill for this task. Review https://www.openagentskill.com/api/skills/marconae-speq-skill/install, then install with: npx skills add marconae/speq-skillRegistry metadata
This page exposes the same decision, trust, audit, use-case, and install signals through the Registry API, so agents can rank this skill without scraping the UI.
Manifest
/api/registry/manifest/marconae-speq-skill
LLM text
/api/registry/manifest/marconae-speq-skill?format=text
Install alias
/api/registry/install/marconae-speq-skill
Recommend
/api/registry/recommend?task=Use%20Speq%20Skill%20in%20an%20agent%20workflow&limit=3
Agent fit
RAG and knowledge
Use-case tags
Platforms
Rust, Claude Code, OpenAI Agents
Audit report
Review install readiness, maintenance, trust, quality, and metadata warnings before adding this skill to an agent workflow.
Agent decision cockpit
Shortlist this skill and compare it with close alternatives before production adoption.
Role in stack
Companion skill
Primary fit
RAG and knowledge
Trust label
Strong shortlist
Install path
Command ready
Use when
Evidence
Review first
Implementation path
Trust profile
Useful candidate with missing or mixed trust signals. Keep it in an isolated workspace until the outcome loop proves task fit.
GitHub adoption
CHECK48 GitHub stars
Stars/forks activity
CHECK48 stars, 9 forks; issue activity unavailable in current metadata
Recent maintenance
PASSPushed today
License clarity
PASSMIT
Good signals
Review before install
Recommended action
Run only in a sandbox and compare close alternatives before using it for real work.
Quality profile
Solid option that is likely worth shortlisting for production workflows.
Workflow fit
Search private knowledge
I need my agent to build a RAG workflow over documents and retrieve reliable context.
Investigate faster
I need my agent to research a topic, compare sources, and produce a concise report.
Manage repositories
I need my agent to triage GitHub issues, review pull requests, and summarize repository changes.
Stack fit
Ingest, retrieve, and cite
A stack for document-heavy agents that ingest files, create searchable knowledge, retrieve relevant context, and answer with grounded sources.
Find, compare, and synthesize
A stack for agents that gather sources, compare claims, summarize long material, and draft useful research briefs.
Turn skills into distribution
A stack for turning newly indexed skills into SEO briefs, social drafts, comparison pages, and reusable publishing workflows.
Alternative shortlist
Similar skills in this category, ranked with the same readiness and quality signals.
A relentless interview that pressure-tests a plan against the codebase, sharpens domain language, and updates CONTEXT.md and ADRs when decisions become durable.
Review a branch or diff against repository standards and the originating spec in two independent analysis passes.
Turn the current conversation and codebase context into a structured implementation spec, then publish it to the configured project issue tracker.
Break a plan, spec, or conversation into independently actionable tracer-bullet tickets with explicit blocking relationships.
<div align="center">
<img src="assets/speq-skill-logo.svg" alt="speq-skill Logo" width="200">
# speq-skill
**A light-weight and straightforward system for spec-driven development with Claude Code and Codex**
[](specs/) [](https://www.rust-lang.org/) [](https://github.com/marconae/speq-skill/actions/workflows/ci.yml) [](LICENSE)
[Getting Started](#getting-started) • [Why](#why-i-built-it) • [How It Works](#how-does-it-work) • [Documentation](./docs/) • [Installation](./docs/installation.md) </div>
---
## Getting Started
```bash 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.
<details> <summary>What does the installer do?</summary>
- Downloads a pre-built `speq` binary 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](https://rustup.rs/)) 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](./docs/installation.md#uninstall).
</details>
---
## 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:
1. A system that
Frameworks & Tools
Decision snapshot
recent repository activity
Audit snapshot
Install and adoption review
Agent-proven evidence
Outcome reports after resolve, review, install, and one narrow run.
No agent outcome data yet. The first agent run can report success, setup needs, risk blocks, failure, or not-relevant through /api/agent/outcome.
Install
Free and open source. Review the audit before production use.
Growth loop
Scenario-led draft for Speq Skill, ready for a manual X post.
Most coding agents don't fail from lack of model power. They fail when repo context disappears. Speq Skill gives coding agents a repeatable way to plan, patch, review, or ship. 48 stars https://www.openagentskill.com/skills/marconae-speq-skill?ref=x #AIAgents
Listing + install path for Speq Skill: https://www.openagentskill.com/skills/marconae-speq-skill?ref=x Install: npx skills add marconae/speq-skill
Listing source
This listing was indexed from public sources and is not marked official until a maintainer claim is approved.
Attribution links to the public repository or creator profile. Creators can claim the listing to update ownership signals.
Claim this skillOwner claim
This community indexed listing is attributed to marconae but is not marked official yet. Claim it to add a verified owner signal and make future launch, install, and audit updates easier to trust.
Creator backlink kit
Show the canonical listing, current trust and audit signals, and real Agent Proven evidence where developers evaluate the repository.
[](https://www.openagentskill.com/skills/marconae-speq-skill)
[](https://www.openagentskill.com/skills/marconae-speq-skill)
[](https://www.openagentskill.com/skills/marconae-speq-skill/audit)
[](https://www.openagentskill.com/skills/marconae-speq-skill)marconae
@marconae
Share whether this skill looks useful for your agent workflow. Aggregated feedback improves rankings over time.
Sandbox only
Grill With Docs
A relentless interview that pressure-tests a plan against the codebase, sharpens domain language, and updates CONTEXT.md and ADRs when decisions become durable.
164.7K stars · 0 installsCode Review
Review a branch or diff against repository standards and the originating spec in two independent analysis passes.
168.6K stars · 0 installsTo Spec
Turn the current conversation and codebase context into a structured implementation spec, then publish it to the configured project issue tracker.
164.7K stars · 0 installsTo Tickets
Break a plan, spec, or conversation into independently actionable tracer-bullet tickets with explicit blocking relationships.
176.7K stars · 0 installs