CtrlK
BlogDocsLog inGet started
Tessl Logo

spec-writer

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).

Invalid
This skill can't be scored yet
Validation errors are blocking scoring. Review and fix them to unlock Quality, Impact and Security scores. See what needs fixing →
SKILL.md
Quality
Evals
Security

Quality

Content

Skipped

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

Description

Skipped

Based 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.

Validation9 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

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

Repository
headout/pm-os-marketplace
Reviewed

Table of Contents

Is this your skill?

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.