Authoring Spec
Productivityauthoring-specAuthoring Spec is an Agent Skill for productivity published in the SocketDev/socket-cli repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
Synthesize the current conversation into a spec (problem, solution, user stories, decisions, test seams, enforcement plan) and publish it to the tracker. No interview — pure synthesis. Use when the user wants a spec (aka PRD) written up from what's been discussed.
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Inspect the Agent Skill at https://github.com/SocketDev/socket-cli/blob/HEAD/.claude/skills/fleet/authoring-spec/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/authoring-spec, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
authoring-spec
Turn the conversation + codebase understanding into a spec. Do NOT interview — just
synthesize what you already know. Adapted from mattpocock/to-spec; the natural
input to decomposing-tickets. Two fleet additions: test seams are a first-class
output, and every spec names its enforcement plan.
1. Explore
Explore the repo (if you haven't) so the spec uses the project's domain vocabulary; respect ADRs in the area.
2. Identify the test seams
Sketch the seams at which the feature is tested. Prefer existing seams; use the
highest seam possible; the fewer across the codebase the better — the ideal is
one. New seams go in at the highest point. Fleet seam doctrine:
test-layout (public interface, no
source-text assertions). Check the seams with the user before writing.
3. Write the spec
Sections: Problem (user's perspective) · Solution (user's perspective) · User Stories (a long numbered "As an , I want , so that " list, exhaustive) · Implementation Decisions (modules, interfaces, schema/API contracts — no file paths or code snippets, they go stale; exception: a prototype snippet that encodes a decision more precisely than prose) · Testing Decisions (what makes a good test here, which modules, prior art) · Enforcement plan · Out of Scope.
Enforcement plan is the fleet's code-is-law addition: name which hook / lint
rule / check script will verify each discipline the feature introduces. A spec that
introduces a rule with no enforcer is policy on paper
(code-is-law).
4. Prose + doctrine pass
The spec is a public-facing surface. Run the prose skill over it and apply
prose-style-and-doctrine:
lead with the point, cut throat-clearers/hedges/filler, evidence over assertion.
Public-surface hygiene: no real customer/company name, no private repo, no Linear
ref, no bare #N.
5. Publish
Publish to the tracker (GitHub via gh, or the Linear MCP save_document /
save_issue tool) with the ready-for-agent triage label. Publishing is mutating +
outward-facing — confirm the destination first.
Completion criterion
The spec has all sections including named test seams and an enforcement plan, passed the prose + doctrine pass, leaks no private name, and is published to the confirmed tracker.