product-spec

Write and maintain Markdown product specification documents with frontmatter versioning.

Updated Jun 5, 2026
One-click install
npx skills add https://github.com/polikeiji/skills --skill product-spec-polikeiji
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: product-spec
Source: https://github.com/polikeiji/skills/tree/main/skills/product-spec
Command: npx skills add https://github.com/polikeiji/skills --skill product-spec-polikeiji

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you turn vague feature ideas into clear, maintainable product specifications that define what a product should do. It is designed for teams that need a shared source of truth for requirements, behavior, and user-facing outcomes.

Core Features & Use Cases

  • Spec Creation and Updates: Draft new product specs or revise existing ones while keeping the focus on behavior rather than implementation.
  • Documentation Structure: Organize specs in docs/specs/ with version history, changelogs, and a readable format for stakeholders.
  • Index Maintenance: Keep docs/specs/README.md current so the full spec library stays easy to browse and understand.
  • Use Case: A product manager can ask for a spec for a new onboarding feature, and the Skill will produce a polished document that captures purpose, behavior, edge cases, and ownership clearly.

Quick Start

Ask the Skill to write or update a product specification for the feature you want documented, and it will create a structured spec in docs/specs/ and update the index when needed.

Frequently Asked Questions about product-spec

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I write a product spec for a new feature?▼

To write a product spec, provide the feature idea and the Skill generates a structured Markdown document in docs/specs/ defining product behavior, user-facing requirements, and edge cases. It organizes specifications with frontmatter versioning and behavior-focused sections for stakeholders.

What is the best way to maintain version history in feature documentation?▼

Maintaining version history in feature documentation is handled through organized Markdown specs with frontmatter versioning and changelogs. The Skill structures documents in docs/specs/ to track updates and ensure stakeholders reference the correct product spec version.

Can I use this to generate a PRD focused on product behavior?▼

Yes, you can generate a PRD focused on product behavior by requesting a product specification. The Skill drafts stakeholder-ready descriptions that define what the product should do, capturing purpose, behavior, and ownership rather than implementation details.

How do I keep a spec library index up to date?▼

To keep a spec library index up to date, the Skill automatically maintains docs/specs/README.md when creating or updating product specifications. This ensures the full index of feature documentation remains synchronized, browsable, and easy to understand.

Does this approach to spec writing work for stakeholder-ready descriptions?▼

Spec writing with this approach produces stakeholder-ready descriptions by organizing requirements into readable Markdown documents. It captures user-facing outcomes and product behavior clearly, serving as a shared source of truth for teams needing structured feature documentation.