Agent skill · developer-tools · mattpocock

to-spec agent skill by mattpocock

Turn the current conversation into a spec and publish it to the project issue tracker: no interview, just synthesis of what you've already discussed.

Source and license

Publishermattpocock
Repositorymattpocock/skills
LicenseMIT
Snapshot2026-10-22
Last repository commit2026-10-09
Instruction size462 words; 69 lines
Bundled files2

Read the publisher’s SKILL.md

Suede Skill Check: 65/100 · D

Report snapshot · · graded-v2

The rubric totals 100 points; published scores are capped at 99. Security scan: not scanned.

Source revision: 49dd158d1076. Report version 351779f5d740. Badge URLs follow the latest listing; save the report to keep this version.

Download report · Request a fresh review

What to review next

  • Structural checks: 48 of 56 points. 8 points for each of the seven graded checks.
  • Boundary clause: 0 of 4 points. 4 when the description says when not to use the skill (“Not for …”, “Do not use …”, “Use … instead”).
  • Example request: 0 of 3 points. 3 when the description quotes an example request (3–60 characters in quotation marks).

Add declarations and bundled files when they describe the skill’s actual needs. Update the source, then request a fresh review with the changed commit or PR.

ComponentPoints earnedAvailable
Structural checks4856
Description length35
Boundary clause04
Example request03
Instruction depth47
Reference files03
Bundled scripts02
Recent maintenance99
Curated-list citations17
Tool permissions declared02
Compatibility declared02

The published score is capped at 99. It measures the published files, documentation and maintenance signals. Security scan: not scanned. This assessment does not include a runtime test or a full installation-dependency review.

Install to-spec

The skills CLI works with Claude Code, Codex, Cursor and other agents; the other routes copy the folder by hand.

Skills CLI
npx skills add https://github.com/mattpocock/skills/tree/main/skills/engineering/to-spec
Claude Code, project-level copy
tmp="$(mktemp -d)"
git clone --depth 1 https://github.com/mattpocock/skills.git "$tmp/repo"
mkdir -p .claude/skills
cp -R "$tmp/repo/"skills/engineering/to-spec .claude/skills/
rm -rf "$tmp"
Codex, project-level copy
tmp="$(mktemp -d)"
git clone --depth 1 https://github.com/mattpocock/skills.git "$tmp/repo"
mkdir -p .agents/skills
cp -R "$tmp/repo/"skills/engineering/to-spec .agents/skills/
rm -rf "$tmp"

For a user-level install, copy the folder to ~/.claude/skills/ (Claude Code) or ~/.agents/skills/ (Codex). Inside Codex, $skill-installer can also fetch a skill from GitHub. New to skills? Read How to install agent skills in Claude Code, Codex and Cursor.

mattpocock/skills is third-party code. Read SKILL.md and any bundled scripts before you install it.

Show the listing and raise the score

to-spec is listed with 65/100 · D. This badge links to its Suede AI listing. Skills scoring 80–99 add a numeric and a letter quality shield; the largest open points for to-spec are structural checks (8), boundary clause (4) and example request (3). Send your repository and the points you want to raise, then request a fresh review after updating the skill. Publishers: read How to get your agent skill found in search and cited by AI assistants.

Suede AI Skills Directory: listed

Markdown
[![Suede AI Skills Directory: listed](https://suedeai.directory/badge.svg)](https://suedeai.directory/mattpocock/skills/to-spec/)
HTML
<a href="https://suedeai.directory/mattpocock/skills/to-spec/"><img src="https://suedeai.directory/badge.svg" alt="Suede AI Skills Directory: listed" height="20"></a>

Compare skills for this task

Browse developer-tools skills or compare scores side by side.