generate-epic

Generate a PRD markdown document from a Notion epic with tasks and sprint metadata.

1|Updated Feb 16, 2026
One-click install
npx skills add https://github.com/codepresso-dev/codepresso-ai-plugin --skill generate-epic-codepresso-dev
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: generate-epic
Source: https://github.com/codepresso-dev/codepresso-ai-plugin/tree/main/skills/generate-epic
Command: npx skills add https://github.com/codepresso-dev/codepresso-ai-plugin --skill generate-epic-codepresso-dev

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Writing a PRD for a Notion epic by hand means copying epic metadata, task lists, and sprint details into a document and then drafting requirements from scratch. This Skill automates that by pulling the epic hierarchy directly from Notion and producing a structured PRD markdown file in your repository. ## Core Features & Use Cases - Notion Epic Resolution: Resolve an epic from an explicit ID (e.g., GP-1014), the current git branch context, or an interactive picker fed by the Notion sprint hierarchy. - Pre-filled PRD Template: Generates a markdown file with metadata table, tasks table (ID, status, assignee, category), sprint info, and a Notion link, plus configurable custom sections. - Optional Planning Interview: Delegates to the OMC Planner agent to interview you about overview, requirements, affected services, technical design, and acceptance criteria, then fills the PRD sections. - Existing File Handling: Detects an existing PRD for the epic and offers Update (refresh metadata/tasks only), Overwrite, or Cancel. - Use Case: A product manager starts a sprint, runs the skill on epic GP-1014, answers a short planning interview, and commits a complete PRD to docs/prd/GP-1014-user-authentication.md. ## Quick Start Ask the assistant to generate a PRD for Notion epic GP-1014 and choose whether to run the planning interview when prompted.

Frequently Asked Questions about generate-epic

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

FAQPage Schema
How do I generate a PRD from a Notion epic?▼

Run the generate-epic skill with an epic ID like GP-1014, or let it resolve the epic from your current branch context or an interactive picker. It fetches the epic data from Notion and writes a structured PRD markdown file to your configured output directory.

How to create product requirements documents automatically from Notion tasks?▼

The skill queries the Notion sprint hierarchy to extract the epic's tasks with IDs, titles, statuses, assignees, and categories, then renders them into a PRD tasks table. An optional planning interview fills in requirements, technical design, and acceptance criteria.

Does generate-epic work without Notion configured?▼

No, it requires Notion access via an API key in the codepresso config or available Notion MCP tools. If Notion is not configured, the skill instructs you to run the setup command first.

What happens if a PRD already exists for the epic?▼

The skill checks the output directory for an existing file matching the epic's unique ID and asks whether to Update, Overwrite, or Cancel. Update mode refreshes only the metadata and tasks tables while preserving your manually written sections.

Can I customize the PRD output location and sections?▼

Yes, the epicDocs config supports outputDir (default docs/prd), includeTaskDetails to omit the tasks section, and customSections to append extra headings with placeholder comments to the generated document.