Getting it into your agent
One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.
npx agentmods add skills/cdavid817/vanehub-ai/spec-optimizernpx skills add cdavid817/vanehub-ai --skill spec-optimizergit clone --depth 1 https://github.com/cdavid817/vanehub-aiWrote this? Show the measurements
A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.
[](https://agentmods.dev/skills/cdavid817/vanehub-ai/spec-optimizer)<a href="https://agentmods.dev/skills/cdavid817/vanehub-ai/spec-optimizer"><img src="https://agentmods.dev/badge/skills/cdavid817/vanehub-ai/spec-optimizer.svg" alt="Measured on agentmods" height="20"></a>What it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5.1 | $0.00051 | $0.00288 |
| Opus 5 | $0.00026 | $0.00144 |
| Sonnet 5 | $0.00010 | $0.00058 |
| Haiku 4.5 | $0.00005 | $0.00029 |
Grade A, and why
spec-optimizer scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 5d ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
What it actually says
Spec Optimizer
Analyze openspec/specs/ only. Never edit openspec/specs/ or openspec/changes/archive/ during analysis.
- Parse capability, Requirement, Scenario,
SHALL, andMUSTunits. - Report duplicate candidates and capability clusters as recommendations, not facts.
- Flag specs above 500 lines or 8,000 tokens unless the user supplies different budgets.
- For every proposed merge, create a mapping from each source Requirement and Scenario to a retained target or an explicit rejection reason.
- Fail the coverage check when any source
SHALLorMUSTis missing from the mapping. - Write review artifacts in a new OpenSpec change:
analysis/report.md,analysis/mapping.md,analysis/coverage.md,analysis/diff.md, and proposed delta specs. - Stop before applying changes. Ask the user to review the artifacts and use the normal OpenSpec workflow for approved edits.
Use the archive catalog only to locate historical context after a main-spec candidate is identified; do not optimize or rewrite archive artifacts.
What ships with it
1 file beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 5d ago First seen · 19 lines · 51 tokens per session scan A a4d3c6a0aebf
spec-optimizer is a skill published in the GitHub repository cdavid817/vanehub-ai (112 stars, last pushed today), licensed Apache-2.0. It adds 51 tokens to every session and 288 once invoked, about $0.0003 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.
Other skills, from other repositories
install-iterm-agent-fork
Install and set up pirate/iterm-agent-fork locally for iTerm2 agent-session forking. Use when a user asks to install, configure, repair, update, or verify the iTerm Agent Fork repo, AutoLaunch script, iTerm Python API launch, Cmd+Shift+F/Cmd+Shift+G key bindings, or optional casr cross-agent handoff support.
kami-deck
A lab-meeting deck on gut-microbiome links to sleep quality — the design, the results, the caveats, and the next experiment. Built as a decision-grade academic research deck for lab group, PI.
orbit-notion
Open Orbit briefing skill — selected by the Orbit pipeline when Notion is the user's only connected connector, or when the user explicitly scopes their daily digest to Notion. Pulls the past 24 hours of document edits, comments, mentions, and database row changes from the user's authenticated Notion connection and…
fs-editorial-forest
Art-directing a fashion house's annual report — the editorial system, the photography rhythm, and the data spreads. Built as a decision-grade design craft deck for brand stakeholders, exec audience.
motion-frames
A single-frame motion-design composition with looping CSS animations — rotating type ring, animated globe, ticking timer, parallax labels. Renders as a hero video poster you can hand straight to HyperFrames or any keyframe-based exporter. Use when the brief asks for "motion design", "animated hero", "loop", "video…
hr-onboarding
A new-hire onboarding plan as a single page — first week schedule, buddy + manager intro, learning track, equipment checklist, and "you're set when…" outcomes. Use when the brief mentions "onboarding", "new hire", "first week plan", or "入职".