Skip to main content
skill CX Codex

product-specs-writer — Claude Code skill: what it does, how to install

product-specs-writer turns a rough feature idea into a PRD, user stories or a technical spec with acceptance criteria a tester can run against.

no license 222 installs ★ 54 updated 2026-02-26

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add ncklrs/startup-os-skills --skill product-specs-writer -a claude-code
Open on GitHub

What product-specs-writer does

The skill kicks in when you ask for a requirements doc, a user story, acceptance criteria, an API contract, a rollout plan behind feature flags or a set of success metrics. Its rules sit in rules/, split by prefix: prd-*, stories-*, criteria-*, technical-*, api-*, edge-*, design-*, rollout-*, metrics-*, maintenance-*.

What you get is a working frame, not prose: a hierarchy running from the problem statement down to implementation, INVEST checks for stories, completeness checklists for both the PRD and the technical spec, and a taxonomy that sorts failures into validation, authorization, resource, system, business-logic and third-party errors.

Anti-patterns get a section of their own — specs written by committee, implementation detail settled too early, a release that tries to cover everything, docs nobody updates. Templates ship as markdown blocks, so porting them into Jira or Notion takes manual work.

What it helps with

  • draft a PRD with problem, metrics and scope boundaries
  • split a feature into INVEST-shaped user stories
  • write acceptance criteria a QA engineer can test
  • document API contracts and versioning rules
  • map edge cases and failure behaviour before coding

Example prompts for the agent

  • Write a PRD for report export: the problem, success metrics, and what falls outside scope.
  • Break this feature into user stories that pass INVEST, with acceptance criteria for each.
  • Draft a technical spec with edge cases and a feature-flag rollout plan.

How to install product-specs-writer

1Skills CLI (Vercel)

npx skills add ncklrs/startup-os-skills --skill product-specs-writer -a claude-code

2Manually: put the files in place

~/.claude/skills/product-specs-writer/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/product-specs-writer/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about product-specs-writer

How do I install product-specs-writer in Claude Code?

Run npx skills add ncklrs/startup-os-skills --skill product-specs-writer -a claude-code. The skill lands in ~/.claude/skills/product-specs-writer/SKILL.md.

What does product-specs-writer do?

It helps you write product documentation: PRDs, user stories, acceptance criteria, technical specs, API contracts, rollout plans and success metrics. The guidance lives in rules/, alongside templates and completeness checklists.

Does it work outside Claude?

Yes, it also runs in Codex, Cursor, GitHub Copilot, Gemini CLI and OpenCode. On GitHub Copilot install it with gh skill install ncklrs/startup-os-skills product-specs-writer.

Similar skills

All skills for Writing and docs →

From the same set51

The whole set →
senior-product-marketer senior-product-marketer guides messaging and user flow decisions for subscription software, focusing on signup gains, faster time-to-value, and revenue expansion. CX Codex +1 231installs customer-lifecycle-marketer customer-lifecycle-marketer is a Claude Code skill with post-sale marketing rules for onboarding, retention, expansion, and referrals. It helps plan activation or respond to churn. CX Codex +1 231installs product-strategist product-strategist guides product vision, market sizing, and monetization decisions directly inside your coding agent. CX Codex +1 231installs performance-marketer performance-marketer is a Claude Code skill that provides paid-acquisition rules for campaigns, landing pages, A/B tests, and attribution. It covers CAC calculations and scaling decisions. CX Codex +1 229installs pricing-strategist pricing-strategist structures SaaS pricing tiers, guides value metric choices, and tunes monetization copy using behavioral economics principles. CX Codex +1 221installs remotion-composition The remotion-composition skill maps Remotion scenes to Sequence blocks and calculates their timing. Use it to plan scene order and transitions before building the scene components. CX Codex +1 208installs product-analyst product-analyst is a Claude Code skill that helps choose product metrics, analyze funnels, and plan experiments. It connects product events to team decisions. CX Codex +1 207installs sales-enablement sales-enablement — a rule set that steers an AI agent through sales training design: new-hire ramp, playbooks, coaching and certification. CX Codex +1 204installs

Project sponsors

Companies that keep this analytics open