spec

Enforce YAML front-matter structure and manage spec discussions in specs/.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/pcortellezzi/rs_trader --skill spec-pcortellezzi
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spec
Source: https://github.com/pcortellezzi/rs_trader/tree/main/.claude/skills/spec
Command: npx skills add https://github.com/pcortellezzi/rs_trader --skill spec-pcortellezzi

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Product Owners and stakeholders often need to view, discuss, and modify functional specs without making code changes, keeping the product backlog aligned with reality.

Core Features & Use Cases

  • View specs by domain, prefix, ID, or file path from the specs/ repository.
  • Discuss, annotate, and propose changes within the spec files while preserving history.
  • Enforce and surface the required YAML front-matter fields (domain, title, version, status, last-updated) and maintain a changelog.

Quick Start

Open specs/ and start reviewing the active spec (e.g., NAV-01) with comments.

Frequently Asked Questions about spec

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

FAQPage Schema
How do I view and discuss functional specifications without modifying the codebase?

To view and discuss functional specifications without touching code, product teams can use a spec workflow that surfaces files by domain or ID, enabling annotation and discussion directly within the spec files while preserving version history.

What YAML front-matter fields are required for functional specs in a product management workflow?

Required YAML front-matter fields for functional specs include domain, title, version, status, and last-updated. Enforcing these header fields ensures that product specifications maintain a changelog and consistent metadata across the repository.

How do I review and propose changes to a spec file while preserving its version history?

You review and propose changes to a spec file by opening the specs/ repository and annotating the active specification. This non-code change workflow allows stakeholders to discuss modifications while the system automatically preserves the version history.

Can I discover specifications across different product domains using a prefix or ID?

Yes, you can discover specifications across different product domains by searching with a specific prefix, ID, or file path. This domain-wide spec discovery allows stakeholders to quickly locate and review active functional requirements.

What is the best way to keep the product backlog aligned with reality when managing specifications?

The best way to keep the product backlog aligned with reality is to maintain a non-code change workflow for specifications. This allows product owners and stakeholders to continuously view, discuss, and modify functional specs without making code changes.