PLANNING AND DELIVERY / Matt Pocock
Conversation to Specification
Turns an already-discussed change into a repository-aware specification for the configured issue tracker.
“Turn the current conversation into a spec and publish it to the project issue tracker: no interview, just synthesis of what you've”
01 / THE REASONING
Why this made the selection.
- Uses existing project context, glossary and architecture decisions before synthesizing requirements.
- Makes scope exclusions, implementation boundaries and test seams explicit instead of treating a discussion transcript as a specification.
02 / THE REVIEW RECORD
What we actually inspected.
Source review has boundaries.
A clear record is more useful than a “safe” badge.
Material inspected
- skills/engineering/to-spec/SKILL.md
- README.md (installation and supported-host sections)
- LICENSE
- skills/engineering/to-spec/agents/openai.yaml
- skills/engineering/setup-matt-pocock-skills/SKILL.md
- skills/engineering/setup-matt-pocock-skills/agents/openai.yaml
- skills/engineering/setup-matt-pocock-skills/domain.md
- skills/engineering/setup-matt-pocock-skills/issue-tracker-github.md
- skills/engineering/setup-matt-pocock-skills/issue-tracker-gitlab.md
- skills/engineering/setup-matt-pocock-skills/issue-tracker-local.md
- skills/engineering/setup-matt-pocock-skills/triage-labels.md
Our findings
- The entry disables implicit invocation and has a matching Codex invocation policy.
- The setup companion supports GitHub, GitLab and local Markdown; the full companion and its tracker/domain templates were read.
Not established by this review
- No upstream definition, helper, installer or generated workload was executed.
- No end-to-end agent session or effectiveness benchmark was run.
The review applies to the material and revision named here. A newer upstream release can change its behavior.
03 / PUT IT TO WORK
Add a skill to your workflow.
DOCUMENTED COMMAND
npx skills add https://github.com/mattpocock/skills/tree/c55ee46073ed923f86ce59a5eb3b6d895095d1b7 --skill to-spec --skill setup-matt-pocock-skillsCopying does not execute this command. It may retrieve a newer version than the reviewed source.
- Install the complete skill directory, including its references and helpers; select your intended host and project scope.
- Run the setup companion once. Inspect its proposed edits to AGENTS.md or CLAUDE.md and docs/agents/ before accepting; it configures GitHub, GitLab or local Markdown tracking.
- Review the instructions before invoking them. The source revision is pinned; the installer was not executed or version-pinned by this review.
Before you start
- Node.js/npm and git for the documented Skills installer
- An agent host that supports the skill format and the tools required by the workflow
- Configured tracker access: authenticated gh or glab for remote issues, or a writable local Markdown directory
04 / FOLLOW THE EVIDENCE
The source trail.
Our notes are separate from the original resource.
Check upstream before adopting a new version.
https://github.com/mattpocock/skills/blob/c55ee46073ed923f86ce59a5eb3b6d895095d1b7/skills/engineering/to-spec/SKILL.md
Supports: summary, upstreamDescription, whySelected, bestFor, limitations, review, access
https://github.com/mattpocock/skills/blob/c55ee46073ed923f86ce59a5eb3b6d895095d1b7/README.md
Supports: install, compatibility
https://github.com/mattpocock/skills/blob/c55ee46073ed923f86ce59a5eb3b6d895095d1b7/LICENSE
Supports: license, access.cost
https://github.com/mattpocock/skills/blob/c55ee46073ed923f86ce59a5eb3b6d895095d1b7/skills/engineering/to-spec/agents/openai.yaml
Supports: review, limitations, install, access
https://github.com/vercel-labs/skills/blob/7407f3893ad4dceab546ac002c3ef806e4000c73/README.md
Supports: install
https://github.com/vercel-labs/skills/blob/7407f3893ad4dceab546ac002c3ef806e4000c73/src/git.ts
Supports: install
https://github.com/vercel-labs/skills/blob/7407f3893ad4dceab546ac002c3ef806e4000c73/src/source-parser.ts
Supports: install
https://github.com/mattpocock/skills/blob/c55ee46073ed923f86ce59a5eb3b6d895095d1b7/skills/engineering/setup-matt-pocock-skills/SKILL.md
Supports: review, limitations, install, access
https://github.com/mattpocock/skills/blob/c55ee46073ed923f86ce59a5eb3b6d895095d1b7/skills/engineering/setup-matt-pocock-skills/agents/openai.yaml
Supports: review, limitations, install, access
https://github.com/mattpocock/skills/blob/c55ee46073ed923f86ce59a5eb3b6d895095d1b7/skills/engineering/setup-matt-pocock-skills/domain.md
Supports: review, limitations, install, access
https://github.com/mattpocock/skills/blob/c55ee46073ed923f86ce59a5eb3b6d895095d1b7/skills/engineering/setup-matt-pocock-skills/issue-tracker-github.md
Supports: review, limitations, install, access
https://github.com/mattpocock/skills/blob/c55ee46073ed923f86ce59a5eb3b6d895095d1b7/skills/engineering/setup-matt-pocock-skills/issue-tracker-gitlab.md
Supports: review, limitations, install, access
https://github.com/mattpocock/skills/blob/c55ee46073ed923f86ce59a5eb3b6d895095d1b7/skills/engineering/setup-matt-pocock-skills/issue-tracker-local.md
Supports: review, limitations, install, access
https://github.com/mattpocock/skills/blob/c55ee46073ed923f86ce59a5eb3b6d895095d1b7/skills/engineering/setup-matt-pocock-skills/triage-labels.md
Supports: review, limitations, install, access