to-spec

to-spec is a skill for Claude Code, Codex from devcxl/mattpocock-skills-zh. It costs 33 tokens per session (691 once invoked), scanned A, original, MIT.

A method for turning the current conversation and codebase understanding into a detailed software specification, then publishing it as an issue in the project’s issue tracker. An issue tracker is a tool for recording and managing development work.

In plain words
What is it for?
Use it to prepare a ready-to-build feature specification, including user stories, implementation decisions, test decisions, and project-specific terminology.
Why use it?
It captures decisions, user needs, testing plans, and out-of-scope work in one shared document without conducting a new interview.

Skill for Claude CodeCodex

Written for Claude Code and Codex: disable-model-invocation in frontmatter, but also agents/openai.yaml present.

Part of the mattpocock-skills plugin — 37 skills shipped together

Good fit Use it to prepare a ready-to-build feature specification, including user stories, implementation decisions, test decisions, and project-specific terminology.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/devcxl/mattpocock-skills-zh/to-spec
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.

Any agent
npx skills add devcxl/mattpocock-skills-zh --skill to-spec
Clone the repo
git clone --depth 1 https://github.com/devcxl/mattpocock-skills-zh

Made for: Claude Code, Codex.

Or install mattpocock-skills, the plugin that ships this one along with the rest of its 37 skills.

Wrote 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.

agentmods badge for to-spec

README.md
[![agentmods](https://agentmods.dev/badge/skills/devcxl/mattpocock-skills-zh/to-spec/github.svg)](https://agentmods.dev/skills/devcxl/mattpocock-skills-zh/to-spec)
Your own site
<a href="https://agentmods.dev/skills/devcxl/mattpocock-skills-zh/to-spec"><img src="https://agentmods.dev/badge/skills/devcxl/mattpocock-skills-zh/to-spec/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for to-spec

Your own site · 80×15
<a href="https://agentmods.dev/skills/devcxl/mattpocock-skills-zh/to-spec"><img src="https://agentmods.dev/badge/skills/devcxl/mattpocock-skills-zh/to-spec.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 33 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 691 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe. Third-party audits
  • NVIDIA SkillSpector pass 7 Sept 2026
How audits are shown
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.1 $0.00033 $0.00691
Opus 5 $0.00016 $0.00345
Sonnet 5 $0.00007 $0.00138
Haiku 4.5 $0.00003 $0.00069

Measured 12d ago against content hash baebc70b3d3f, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-12, from the pricing page.

Security

Grade A, and why

to-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 12d 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.

skills/engineering/to-spec/SKILL.md · 76 lines

What it actually says

本技能获取当前的对话上下文和对代码库的理解,产出一份 spec。不要盘问用户——只综合你已经知道的内容。

issue 跟踪器和分类标签词汇应该已经提供给你了——如果没有,告诉用户运行 /setup-matt-pocock-skills

流程

  1. 如果还没探索过,先探索仓库,了解代码库的当前状态。整个 spec 都使用项目的领域词汇表术语,并尊重你正在触碰的区域的任何 ADR。

  2. 勾勒出你将测试该功能的接缝。已有接缝应优先于新接缝。用尽可能高的接缝。如果需要新接缝,在你能达到的最高点提出。代码库中的接缝越少越好——理想数量是一个。

    与用户确认这些接缝符合他们的预期。

  3. 用下面的模板写 spec,然后发布到项目的 issue 跟踪器。打上 ready-for-agent 分类标签——不需要再做分类。

问题陈述

用户正面临的问题,从用户的角度描述。

解决方案

问题的解决方案,从用户的角度描述。

用户故事

一个长长的、编号的用户故事列表。每个用户故事遵循以下格式:

  1. 作为一个<角色>,我想要<功能>,以便<收益>

这份用户故事列表应该极其详尽,覆盖该功能的方方面面。

实现决策

已作出的实现决策列表。可以包括:

  • 将要构建/修改的模块
  • 将被修改的那些模块的接口
  • 来自开发者的技术澄清
  • 架构决策
  • Schema 变更
  • API 契约
  • 具体交互

不要包含具体的文件路径或代码片段。它们可能很快就过时了。

例外:如果原型产出了比散文更精确地编码某个决策的片段(状态机、reducer、schema、类型形态),把它内联进相关决策中,并简要注明它来自原型。裁到决策密集的部分——不是可运行的演示,只是重要的片段。

测试决策

已作出的测试决策列表。包括:

  • 什么构成好测试的描述(只测外部行为,不测实现细节)
  • 哪些模块将被测试
  • 测试的先例(即代码库中类似的测试类型)

范围外

本 spec 范围之外的内容描述。

补充说明

关于该功能的任何补充说明。

Files

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.

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. 12d ago First seen · 76 lines · 33 tokens per session scan A baebc70b3d3f

Subscribe to this mod's changes

to-spec is a skill published in the GitHub repository devcxl/mattpocock-skills-zh (343 stars, last pushed 7d ago), licensed MIT. It adds 33 tokens to every session and 691 once invoked, about $0.0002 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.

Related

Other skills, from other repositories

openspec-bulk-archive-change

Archive multiple completed changes at once. Use when archiving several parallel changes.

jim60105/copilot-prompt · 23 tokens

requirement-delivery

A workflow for turning a new software request into a small, working deliverable. It clarifies acceptance criteria, identifies boundaries, breaks work into demonstrable parts, and looks for existing code or tools to reuse.

Wade-DevCode/awesome-coding-skills-cn · 34 tokens

loop-orchestrator

Operate a fleet of durable agent loops under .loop/ — schedule which loop runs next, assign agents to roles (maker vs checker), enforce promotion gates from propose-only to write access, allocate budgets, detect stalled or dead loops, and roll up fleet status into one report. Use when asked to "run the loops"…

frankxai/claude-skills-library · 113 tokens

creator-productivity

Task management and workspace memory for creative work sessions. Manages a TASKS.md file for project tracking, a two-tier memory system (CREATOR.md + creator-memory/), and a daily sprint structure. Use when organizing creative projects, tracking content tasks, or starting a focused work session.

frankxai/claude-skills-library · 62 tokens

product-management-expert

Product management expertise for strategy, discovery, prioritization, roadmaps, PRDs, metrics, and stakeholder communication. Use when defining what to build, why, and how to measure success.

frankxai/claude-skills-library · 43 tokens

todo-discipline

Use when starting any complex task (3+ steps) or before declaring work complete. Enforces todo/task state to match reality — merge updates + read verification. Prevents false completion.

frankxai/claude-skills-library · 41 tokens