write-product-spec — Skills

What it does

For UI / UX features: the human using Warp.

For a data model: the code that reads and writes that model.

For an API, protocol, or library: the callers of that API — other services, client code, plugins, or agents.

For a CLI tool or developer-facing surface: the developer invoking it.

a Linear ticket number (e.g. specs/APP-1234/PRODUCT.md)

a GitHub issue id, prefixed with gh- (e.g. specs/gh-4567/PRODUCT.md)

a short kebab-case feature name (e.g. specs/vertical-tabs-hover-sidecar/PRODUCT.md)

write product spec

Source

Repository: https://github.com/warpdotdev/common-skills

write-product-spec FAQ

What does the write-product-spec skill do?

Write a PRODUCT.md spec for a significant user-facing feature in Warp, focused on detailed behavior and validation. Use when the user asks for a product spec, desired behavior doc, or PRD, wants to define feature behavior before implementation, or when the feature is substantial or behaviorally ambiguous enough that a written spec would improve implementation or review. For UI / UX features: the human using Warp. For a data model: the code that reads and writes that model.

What does write-product-spec require?

Configuration keys: PRODUCT, TECH, DECISIONS.

How do I install write-product-spec?

Run: npx -y skills add https://github.com/warpdotdev/common-skills --skill write-product-spec --agent claude-code — the source lives at github.com/warpdotdev/common-skills.

Maintain write-product-spec?

Let people know it's listed here — add the badge (live metrics, light/dark aware) or a plain link to your README or docs.

[![write-product-spec on getagentictools](https://getagentictools.com/badge/skills/warpdotdev-common-skills-write-product-spec.svg)](https://getagentictools.com/skills/warpdotdev-common-skills-write-product-spec?ref=badge)

npx agentictools info skills/warpdotdev-common-skills-write-product-spec

The second line is the CLI lookup for this page — handy in READMEs and docs.