prd-task

Converts Markdown product requirement documents into executable JSON for AI agents.

Updated Nov 3, 2019
One-click install
npx skills add https://github.com/gil0mendes/dotfiles --skill prd-task-gil0mendes
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: prd-task
Source: https://github.com/gil0mendes/dotfiles/tree/main/configs/opencode/skill/prd-task
Command: npx skills add https://github.com/gil0mendes/dotfiles --skill prd-task-gil0mendes

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill automates the conversion of human-readable markdown Product Requirement Documents (PRDs) into a structured JSON format that AI agents can directly use for task execution and progress tracking.

Core Features & Use Cases

  • PRD to JSON Conversion: Transforms markdown PRDs into executable JSON, defining tasks, verification steps, and context.
  • State Management: Organizes converted PRDs and their progress within a dedicated .opencode/state/ directory.
  • Use Case: After writing a new feature's PRD in markdown, use this skill to prepare it for an AI agent to autonomously implement the feature by breaking it down into actionable tasks and verification steps.

Quick Start

Use the prd-task skill to convert the attached file 'prd-user-auth.md'.

Frequently Asked Questions about prd-task

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

FAQPage Schema
How do I convert a markdown PRD to JSON for AI agent task execution?

To convert a markdown PRD to JSON, you parse the document to extract tasks, verification steps, context, and non-goals. This generates a structured JSON schema that AI agents can directly use for autonomous task completion and progress tracking.

What is the best way to structure a Product Requirement Document for automated task breakdown?

The best way to structure a PRD for task breakdown is using a specific markdown format that distinctly separates tasks, context, verification steps, and non-goals. This allows the parser to accurately extract parameters and generate an executable JSON schema.

Can I use markdown files to define executable tasks and verification steps for AI agents?

Yes, you can use markdown files to define executable tasks. The conversion process parses your markdown PRD to extract tasks and verification steps, outputting a JSON format that AI agents directly use for autonomous execution and progress tracking.

Does converting PRDs to JSON organize project state and progress tracking?

Yes, converting PRDs to JSON organizes project state. The process automatically structures converted PRDs and their execution progress within a dedicated `.opencode/state/` directory for ongoing tracking.

What limitations exist when parsing markdown PRDs into executable JSON schemas?

A key limitation is the strict adherence to a specific markdown input format. If your PRD does not follow the required structure, the parser may fail to accurately extract tasks, context, and non-goals for the JSON schema.