spec

A planning aid for one GitHub issue, where a GitHub issue is a shared record of a coding task or bug. It compares the proposed plan with the issue's acceptance criteria—the conditions that must be met for the work to be accepted—and drafts a comment.

In plain words
What is it for?
Use it to understand an issue, review or create an implementation plan, check acceptance criteria, and prepare a GitHub comment.
Why use it?
It helps reveal missing requirements, risks, or gaps before coding begins. It also gives the team a clear progress update to share on the issue.

Skill for Claude CodeCodex

Install

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.

agentmods
npx agentmods add skills/sequant-io/sequant/spec
Any agent
npx skills add sequant-io/sequant --skill spec
Clone the repo
git clone --depth 1 https://github.com/sequant-io/sequant

Made for: Claude Code, Codex.

Per session 19 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 4,627 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

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.

ModelPer sessionOnce invoked
Fable 5 $0.00019 $0.04627
Opus 5 $0.00010 $0.02313
Sonnet 5 $0.00004 $0.00925
Haiku 4.5 $0.00002 $0.00463

Measured yesterday against content hash 0f6767999181, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

spec 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 yesterday.

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.

.claude/skills/spec/SKILL.md · 420 lines

How it starts

The opening of the file, as written. The whole thing — 420 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Local overrides (read this first). Before following any instruction below, check whether .claude/.local/skills/spec/overrides.md exists. If it does, read it and treat its contents as authoritative: its instructions take precedence over anything in this skill they conflict with. This is the supported way to tailor /spec without forking it — overrides.md lives under .claude/.local/, which sequant update and sync never overwrite.

Planning Agent

Phase 1 "Planning Agent." Understands the issue and AC, reviews or synthesizes a plan, identifies gaps and risks, and drafts a GitHub issue comment.

Worktree Contract

No worktree needed. Planning happens in the main repository directory. The worktree is created later — by the orchestrator (/fullsolve Phase 1.5, or sequant run) when one is driving, otherwise by /exec itself.

This skill only ever reads git worktree list, for in-flight collision detection. Do not create a worktree here, and do not describe one as existing after /spec — downstream skills that trust such a claim end up implementing in the main checkout (#899, and the line this restores was dropped by #515).

Platform Detection — Run First

gh --version >/dev/null 2>&1 && GITHUB_AVAILABLE=true || GITHUB_AVAILABLE=false
SETTINGS_AVAILABLE=false; [ -f ".sequant/settings.json" ] && SETTINGS_AVAILABLE=true
  • GitHub unavailable: Skip phase detection, label review, auto-comment. Prompt user for AC from description text.
  • Settings unavailable: Use defaults silently (sequential agents, no custom scope config).

Phase Detection

If GitHub is available, check for prior phase completion:

phase_data=$(gh issue view <issue-number> --json comments --jq '[.comments[].body]' | \
  grep -o '{[^}]*}' | grep '"phase"' | tail -1 || true)
  • spec:completed or later phase detected → Skip with message
  • spec:failed → Re-run
  • No markers / API error → Normal execution

Read the full file on GitHub · 420 lines

Files

What ships with it

4 files 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.

Changes

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.

  1. yesterday First seen · 420 lines · 19 tokens per session scan A 0f6767999181

Subscribe to this mod's changes

spec is a skill published in the GitHub repository sequant-io/sequant (1 stars, last pushed yesterday), licensed MIT. It adds 19 tokens to every session and 4,627 once invoked, about $0.0001 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-31.

Related

Other skills, from other repositories

agent-estate

Perpetual autonomous work loop for Claude Code — no end condition, no memory regression, no context overfill. Maintains a persistent ledger across all sessions.

MercuriusDream/agent-estate · 36 tokens

citation-audit

Zero-context verification that every bibliographic entry in the paper is real, correctly attributed, and used in a context the cited paper actually supports — catching hallucinated authors, wrong years, fabricated venues, version mismatches, and wrong-context citations. Use when user says "审查引用", "check citations"…

wanshuiyin/Auto-claude-code-research-in-sleep · 86 tokens

paper-illustration

Generate publication-quality AI illustrations for academic papers using Gemini image generation. Creates architecture diagrams, method illustrations with Claude-supervised iterative refinement loop. Use when user says "生成图表", "画架构图", "AI绘图", "paper illustration", "generate diagram", or needs visual figures for papers.

wanshuiyin/Auto-claude-code-research-in-sleep · 67 tokens

paper-illustration-image2

Generate publication-quality academic illustrations through a local Codex app-server bridge that uses Codex native image generation. This is a separate experimental alternative to paper-illustration, intended for Claude Code users who want a GPT-image-style renderer without modifying the original skill.

wanshuiyin/Auto-claude-code-research-in-sleep · 59 tokens

experiment-plan

Turn a refined research proposal or method idea into a detailed, claim-driven experiment roadmap. Use after research-refine, or when the user asks for a detailed experiment plan, ablation matrix, evaluation protocol, run order, compute budget, or paper-ready validation that supports the core problem, novelty…

wanshuiyin/Auto-claude-code-research-in-sleep · 80 tokens

paper-writing

Workflow 3: Full paper writing pipeline that goes from a narrative report to a polished, submission-ready PDF. Use when user says "写论文全流程", "write paper pipeline", "从报告到PDF", "paper writing", or wants the complete paper generation workflow.

wanshuiyin/Auto-claude-code-research-in-sleep · 58 tokens