Setup Matt Pocock Skills
bestofjs/bestofjs
Configure this repo for the engineering skills — set up its issue tracker, triage label vocabulary, and domain doc layout.
将当前对话转化为 spec 并发布到项目的 issue tracker——不访谈，只综合你们已经讨论过的内容. An agent skill from devcxl/mattpocock-skills-zh.
Install To Spec
$ npx skills add devcxl/mattpocock-skills-zh --skill to-spec -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install devcxl/mattpocock-skills-zh to-spec --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/devcxl/mattpocock-skills-zh.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/engineering/to-spec .claude/skills/to-spec && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "to-spec" agent skill from https://github.com/devcxl/mattpocock-skills-zh/tree/main/skills/engineering/to-spec into .claude/skills/to-spec/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "to-spec", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/devcxl/mattpocock-skills-zh/tree/main/skills/engineering/to-specType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add devcxl/mattpocock-skills-zh --skill to-spec -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install devcxl/mattpocock-skills-zh to-spec --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/devcxl/mattpocock-skills-zh.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/engineering/to-spec .agents/skills/to-spec && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "to-spec" agent skill from https://github.com/devcxl/mattpocock-skills-zh/tree/main/skills/engineering/to-spec into .agents/skills/to-spec/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "to-spec", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add devcxl/mattpocock-skills-zh --skill to-spec -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install devcxl/mattpocock-skills-zh to-spec --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/devcxl/mattpocock-skills-zh.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/engineering/to-spec .cursor/skills/to-spec && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "to-spec" agent skill from https://github.com/devcxl/mattpocock-skills-zh/tree/main/skills/engineering/to-spec into .cursor/skills/to-spec/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "to-spec", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/devcxl/mattpocock-skills-zh.git --path skills/engineering/to-spec--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add devcxl/mattpocock-skills-zh --skill to-spec -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install devcxl/mattpocock-skills-zh to-spec --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/devcxl/mattpocock-skills-zh.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/engineering/to-spec .gemini/skills/to-spec && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "to-spec" agent skill from https://github.com/devcxl/mattpocock-skills-zh/tree/main/skills/engineering/to-spec into .gemini/skills/to-spec/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "to-spec", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install devcxl/mattpocock-skills-zh to-specInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add devcxl/mattpocock-skills-zh --skill to-spec -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/devcxl/mattpocock-skills-zh.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/engineering/to-spec .github/skills/to-spec && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "to-spec" agent skill from https://github.com/devcxl/mattpocock-skills-zh/tree/main/skills/engineering/to-spec into .github/skills/to-spec/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "to-spec", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add devcxl/mattpocock-skills-zh --skill to-spec -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install devcxl/mattpocock-skills-zh to-spec --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/devcxl/mattpocock-skills-zh.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/engineering/to-spec .opencode/skills/to-spec && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "to-spec" agent skill from https://github.com/devcxl/mattpocock-skills-zh/tree/main/skills/engineering/to-spec into .opencode/skills/to-spec/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "to-spec", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
to-spec- GitHub stars
- 433
- Token cost
- ~286 tokens
- SKILL.md length
- 60 words
- Files
- 2
- Skills in repo
- 20
- Repo updated
- First seen
- Licence
- MIT
At a glance
将当前对话转化为 spec 并发布到项目的 issue tracker——不访谈，只综合你们已经讨论过的内容. An agent skill from devcxl/mattpocock-skills-zh.
- Works in 3 steps: 如果还没探索过，先探索仓库，了解代码库的当前状态。整个 spec… → 勾勒出你将测试该功能的接缝。已有接缝应优先于新接缝。用尽可能高的接缝。如果需要新接… → 用下面的模板写 spec，然后发布到项目的 issue 跟踪器。打上…
- Tasks that involve Issue triage
- SKILL.md covers 流程, 问题陈述, 解决方案 and 用户故事, plus 4 more sections
- Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
What it does
To Spec is an agent skill from devcxl/mattpocock-skills-zh. 将当前对话转化为 spec 并发布到项目的 issue tracker——不访谈，只综合你们已经讨论过的内容。
Its SKILL.md is about 290 tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files (for example `agents/openai.yaml`).
It sits in Development, covering Issue triage. The repository describes itself as: Matt Pocock 技能集的中文翻译版 — 地道中文，原汁原味的技术术语。基于 mattpocock/skills 复刻。每日中午12点钟同步. The licence is MIT.
When your agent uses it
- Tasks that involve Issue triage
Example prompts
- “/to-spec”
Workflow steps
3 steps, taken from the first numbered list in SKILL.md.
- 如果还没探索过，先探索仓库，了解代码库的当前状态。整个 spec 都使用项目的领域词汇表术语，并尊重你正在触碰的区域的任何 ADR。
- 勾勒出你将测试该功能的接缝。已有接缝应优先于新接缝。用尽可能高的接缝。如果需要新接缝，在你能达到的最高点提出。代码库中的接缝越少越好——理想数量是一个。
- 用下面的模板写 spec，然后发布到项目的 issue 跟踪器。打上 ready-for-agent 分类标签——不需要再做分类。
What it can do on your machine
Read from SKILL.md and the folder at commit b72cc5b. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
No scripts in the folder and no shell commands in SKILL.md.
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
To Spec loads about 286 tokens when it runs. Until then it costs about 16 tokens; SKILL.md has 60 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check passed
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
SKILL.md
The full file from devcxl/mattpocock-skills-zh at commit b72cc5b, republished under its MIT licence (© devcxl). 60 words, ~286 tokens.
Download SKILL.mdSave it as
.claude/skills/to-spec/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.- name
- to-spec
- description
- 将当前对话转化为 spec 并发布到项目的 issue tracker——不访谈，只综合你们已经讨论过的内容。
- disable-model-invocation
- true
本技能获取当前的对话上下文和对代码库的理解，产出一份 spec。不要盘问用户——只综合你已经知道的内容。
issue 跟踪器和分类标签词汇应该已经提供给你了——如果没有，告诉用户运行 /setup-matt-pocock-skills。
流程
如果还没探索过，先探索仓库，了解代码库的当前状态。整个 spec 都使用项目的领域词汇表术语，并尊重你正在触碰的区域的任何 ADR。
勾勒出你将测试该功能的接缝。已有接缝应优先于新接缝。用尽可能高的接缝。如果需要新接缝，在你能达到的最高点提出。代码库中的接缝越少越好——理想数量是一个。
与用户确认这些接缝符合他们的预期。
用下面的模板写 spec，然后发布到项目的 issue 跟踪器。打上
ready-for-agent分类标签——不需要再做分类。
<spec-template>问题陈述
用户正面临的问题，从用户的角度描述。
解决方案
问题的解决方案，从用户的角度描述。
用户故事
一个长长的、编号的用户故事列表。每个用户故事遵循以下格式：
- 作为一个<角色>，我想要<功能>，以便<收益>
<user-story-example>
1. 作为手机银行客户，我想看到我账户的余额，以便能对消费做出更明智的决定
</user-story-example>这份用户故事列表应该极其详尽，覆盖该功能的方方面面。
实现决策
已作出的实现决策列表。可以包括：
- 将要构建/修改的模块
- 将被修改的那些模块的接口
- 来自开发者的技术澄清
- 架构决策
- Schema 变更
- API 契约
- 具体交互
不要包含具体的文件路径或代码片段。它们可能很快就过时了。
例外：如果原型产出了比散文更精确地编码某个决策的片段（状态机、reducer、schema、类型形态），把它内联进相关决策中，并简要注明它来自原型。裁到决策密集的部分——不是可运行的演示，只是重要的片段。
测试决策
已作出的测试决策列表。包括：
- 什么构成好测试的描述（只测外部行为，不测实现细节）
- 哪些模块将被测试
- 测试的先例（即代码库中类似的测试类型）
范围外
本 spec 范围之外的内容描述。
补充说明
关于该功能的任何补充说明。
</spec-template>© devcxl, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
SKILL.md and 1 other file in skills/engineering/to-spec of devcxl/mattpocock-skills-zh.
- SKILL.md
- agents/openai.yaml
Open the folder on GitHubat commit b72cc5b
Compare with similar skills
To Spec next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| To Spec this skilldevcxl/mattpocock-skills-zh | 433 | — | ~286 | Automated safety check: Pass | MIT | |
| Setup Matt Pocock Skillsbestofjs/bestofjs | 3.1k | 20 repos | ~1.7k | Automated safety check: Pass | MIT | |
| Wayfinderbestofjs/bestofjs | 3.1k | 20 repos | ~2.9k | Automated safety check: Pass | MIT | |
| Windows App SDK Issue Triage Reportmicrosoft/WindowsAppSDK | 4.7k | — | ~3.4k | Automated safety check: Pass | Apache-2.0 | |
| Exposed Bug Fix WorkflowJetBrains/Exposed | 9.3k | — | ~3.8k | Automated safety check: Pass | Apache-2.0 | |
| Archify Reviewtt-a1i/archify | 79k | — | ~415 | Automated safety check: Pass | MIT |
Similar skills
Wayfinder
bestofjs/bestofjs
Plan a huge chunk of work — more than one agent session can hold — as a shared map of decision tickets on your issue tracker, and resolve them one at a time until the way to the destination is clear.
- Official
Windows App SDK Issue Triage Report
microsoft/WindowsAppSDK
Generates GitHub Feature Area Status reports for the Windows App SDK repository, scoring issues so teams can see what needs attention in each area.
- Official
Exposed Bug Fix Workflow
JetBrains/Exposed
Takes a GitHub or YouTrack issue for the Exposed project through reproduction, a failing test, a fix, validation and a pull request.
Archify Review
tt-a1i/archify
Review Archify issues, PRs, or code through value, cost, and impact to support evidence-based maintenance decisions. Use for issue triage, change reviews, and…
Bug Triage
symfony/symfony
Decide whether open Bug PRs target the correct branch. An agent skill from symfony/symfony.
More from devcxl/mattpocock-skills-zh
All 20 skills in this repoTriage
devcxl/mattpocock-skills-zh
将 issue 和外部 PR 推过一组分诊角色的状态机——分类、验证、必要时盘问，并写出 agent 就绪的任务简报. An agent skill from devcxl/mattpocock-skills-zh.
Git Guardrails Claude Code
devcxl/mattpocock-skills-zh
设置 Claude Code 钩子，在危险 Git 命令（push、reset --hard、clean、branch -D 等）执行前将其拦截。当用户想要防止破坏性 Git 操作、添加 Git 安全钩子或在 Claude Code 中阻止 git push/reset 时使用。
Codebase Design
devcxl/mattpocock-skills-zh
设计深度模块的共享词汇。当用户想要设计或改进模块的接口、寻找深化机会、决定 seam 的位置、让代码更可测试或更易被 AI 导航，或者其他 skill 需要深度模块词汇时使用。
Diagnosing Bugs
devcxl/mattpocock-skills-zh
针对棘手 bug 和性能回归的诊断循环。当用户说"诊断"/"调试这个"，或报告某处崩溃/报错/不正常/缓慢时使用. An agent skill from devcxl/mattpocock-skills-zh.
Domain Modeling
devcxl/mattpocock-skills-zh
构建和完善项目的领域模型。当讨论代码库术语、编写或编辑 GLOSSARY.md，或记录或编辑 ADR 时使用. An agent skill from devcxl/mattpocock-skills-zh.
Migrate To Shoehorn
devcxl/mattpocock-skills-zh
将测试文件从 as 类型断言迁移到 @total-typescript/shoehorn。当用户提到 shoehorn、想要在测试中替换 as、或需要部分测试数据时使用。
Related
Categories
Questions about To Spec
What does To Spec do?
将当前对话转化为 spec 并发布到项目的 issue tracker——不访谈，只综合你们已经讨论过的内容. An agent skill from devcxl/mattpocock-skills-zh. To Spec is an agent skill from devcxl/mattpocock-skills-zh.
When should I use To Spec?
To Spec fits situations like: tasks that involve Issue triage.
How do I install To Spec in Claude Code?
Run `npx skills add devcxl/mattpocock-skills-zh --skill to-spec -a claude-code`. Or copy the skill folder (skills/engineering/to-spec in devcxl/mattpocock-skills-zh) into .claude/skills/to-spec in your project. Claude Code loads it when a task matches its description.
How do I install To Spec in Codex?
Run `npx skills add devcxl/mattpocock-skills-zh --skill to-spec -a codex`. Or copy the skill folder (skills/engineering/to-spec in devcxl/mattpocock-skills-zh) into .agents/skills/to-spec in your project. Codex loads it when a task matches its description.
Can I use To Spec in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add devcxl/mattpocock-skills-zh --skill to-spec -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/to-spec, .gemini/skills/to-spec, .github/skills/to-spec and .opencode/skills/to-spec in your project.
What does To Spec need to run?
SKILL.md names no scripts, command-line tools or credentials: To Spec is instructions for the agent only.
Does To Spec access the network?
SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.
Is To Spec safe to install?
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
What licence does To Spec use?
To Spec is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does To Spec use?
About 286 tokens (SKILL.md is roughly 1.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
What are the alternatives to To Spec?
Skills that share tags, products or a category with To Spec: Setup Matt Pocock Skills (bestofjs/bestofjs, 3.1k stars), Wayfinder (bestofjs/bestofjs, 3.1k stars), Windows App SDK Issue Triage Report (microsoft/WindowsAppSDK, 4.7k stars) and Exposed Bug Fix Workflow (JetBrains/Exposed, 9.3k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains To Spec?
devcxl (a GitHub user) maintains it in devcxl/mattpocock-skills-zh, which has 433 GitHub stars. The repository holds 20 skills in this directory. The repository was last updated on October 5, 2026.
Source: devcxl/mattpocock-skills-zh on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.