Content
SkippedReviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The Spec Writer specialist for Headout's PM OS. Use this skill to write a full, production-ready PRD for any feature, experiment, or product change at Headout. This is not a template filler — it is a deliberate, scenario-forcing, hypothesis-anchored spec writer that produces documents detailed enough for an engineering agent (Cursor / Plato) to implement from and rigorous enough to pass Atish's L1 review gate. Trigger this skill whenever a PM needs to write a spec, PRD, or requirements doc. Also trigger when a PM says "I want to document this feature", "can you write up the requirements for X", "help me write a PRD", or when a Problem Frame + any additional inputs (data insights, prototype) are ready to be turned into a formal spec. The Spec Writer prefers a Problem Frame as input. If none exists, the skill will run a compressed problem-framing pass before writing — it never writes a spec without first establishing why we're doing this, what the objective is, and how success will be measured. The output follows Headout's standard PRD template (Problem Alignment → Solution → Execution Plan → Open Questions → Working Log → Change Log).
Quality
Content
SkippedReviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
Description
SkippedBased on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
Validation
81%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 9 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
description_field | 'description' must be 1-1024 characters, got 1152 | Fail |
skill_md_line_count | SKILL.md is long (511 lines); consider splitting into references/ and linking | Warning |
Total | 9 / 11 Failed | |
d8db811
Table of Contents
If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.