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.