skills.rest
DATA-AI-XYZ
DATA-AI-XYZOFFICIAL
Explore all skills by this author →
GitHub

draft-epic

Drafts an Epic markdown file from an OKR key result or PRD section with mandatory strategic linkage.

Updated May 25, 2026
Search Tags:#product management#claude code#okr#prd#markdown template#epic drafting#strategic linkage
One-click install
npx skills add https://github.com/DATA-AI-XYZ/Tandem --skill draft-epic-data-ai-xyz
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: draft-epic
Source: https://github.com/DATA-AI-XYZ/Tandem/tree/main/skills/draft-epic
Command: npx skills add https://github.com/DATA-AI-XYZ/Tandem --skill draft-epic-data-ai-xyz

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Turning an approved strategic bet (an OKR key result or PRD section) into a well-formed Epic is often ad hoc: scope creeps, success criteria stay vague, and the link back to strategy gets lost. This Skill enforces a governed drafting process where every Epic is a versioned markdown artefact with mandatory strategic linkage. ## Core Features & Use Cases - Template-driven drafting: Uses the project's EPIC.template.md verbatim to produce 30-Epics/EPIC-NN-<slug>.md with all required sections filled. - Mandatory strategic linkage: Requires frontmatter okr: or prd_section: referencing the source document, and aborts if linkage cannot be established. - Automatic numbering: Globs existing EPIC-*.md files to compute the next free EPIC-NN, preventing collisions. - Use Case: After approving a Q3 OKR, ask the assistant to draft an Epic from KR2; it reads the OKR file, applies the template, outlines 3-7 candidate Features, and shows the planned file tree for approval before writing. ## Quick Start Ask the assistant to draft an epic from a specific OKR or PRD file, for example: draft an epic from _00-Project-Management/00-Strategy/OKR-2025-Q3.md key result 2.

Frequently Asked Questions about draft-epic

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

FAQPage Schema
How do I draft an epic from an OKR or PRD?▼

Invoke the draft-epic command and provide the path to the source OKR or PRD file, or paste the key result text inline. The Skill reads the source, applies the EPIC template verbatim, and writes EPIC-NN-<slug>.md after you approve the planned file tree.

What happens if I draft an epic without an OKR or PRD reference?▼

The Skill aborts. Strategic linkage is mandatory: the Epic frontmatter must contain okr: or prd_section: with a real value, per the kit's strategy-linkage rule in SOP.md. You will be asked which OKR or PRD the Epic moves.

How is the epic number EPIC-NN assigned?▼

The Skill globs existing files matching 30-Epics/EPIC-*.md, finds the maximum NN, increments by one, and pads to two digits. It never invents or reuses a number.

Does draft-epic also create the Feature files?▼

No. It only outlines 3-7 Features at a high level (title plus one-line goal) inside the Epic's Features section. Creating FEAT files is handled by the separate split-into-features command.

What are the limitations of the draft-epic workflow?▼

It cannot proceed without a clear business outcome (metric and target), and it proposes splitting any Epic estimated at more than four weeks of solo work. It also requires the project's template, SOP, and standards files to exist.

Related Skills

Explore More Product & Management Skills→
propane-aipropane-ai
4

plan-creation

Generate strategic and operational plans with OKRs, milestones, and timelines.

Official
Intermediate
Hassan-Ali-Mehdi-3024Hassan-Ali-Mehdi-3024

user-story-decomposition

Decompose features or PRDs into INVEST-compliant user stories with acceptance criteria.

Community
Advanced
MS33834MS33834

Goal Definition

Transforms vague requests into measurable goals with success criteria and scope.

Community
Intermediate
petrSimonidesXartpetrSimonidesXart

consistency-check

Detect and report inconsistencies across Epics, Stories, Plans, and PRDs.

Community
Advanced