skills.rest
fall-out-bug
fall-out-bugCOMMUNITY
Explore all skills by this author →
GitHub

@prd — PRD Generation Skill

Generate PRDs with Mermaid and PlantUML diagrams from code annotations.

19|Updated Dec 28, 2025
Search Tags:#automation#project management#documentation#code generation#diagrams#prd
One-click install
npx skills add https://github.com/fall-out-bug/sdp --skill prd-prd-generation-skill
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: @prd — PRD Generation Skill
Source: https://github.com/fall-out-bug/sdp/tree/main/.claude/skills/prd
Command: npx skills add https://github.com/fall-out-bug/sdp --skill prd-prd-generation-skill

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill automates the creation and maintenance of Project Requirement Documents (PRDs) and generates diagrams directly from code annotations, ensuring documentation stays synchronized with the codebase.

Core Features & Use Cases

  • Automated PRD Scaffolding: Detects project type (service, library, CLI) and generates a PRD with appropriate sections.
  • Diagram Generation: Creates Mermaid and PlantUML diagrams from inline code annotations (@prd_flow, @prd_step).
  • Validation: Enforces section limits and frontmatter completeness.
  • Update Mode: Regenerates diagrams and updates PRD frontmatter based on code changes.
  • Use Case: When starting a new service, use @prd "my-new-service" to quickly generate a structured PRD. Later, as you add Python functions with @prd_step annotations, run @prd "my-new-service" --update to automatically update sequence diagrams in your PRD.

Quick Start

Use the prd skill to generate a new PRD for a project named 'hw-checker'.

Frequently Asked Questions about @prd — PRD Generation Skill

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

FAQPage Schema
How do I generate a PRD with diagrams directly from code annotations?▼

To generate a PRD with diagrams, annotate your Python, Bash, or YAML code using `@prd_flow` and `@prd_step` tags. The Skill detects your project type and scaffolds a Project Requirement Document with automatic Mermaid and PlantUML diagrams.

Can I automatically update sequence diagrams in my PRD after code changes?▼

Yes, you can update sequence diagrams by running the update mode. After adding or modifying Python functions with `@prd_step` annotations, execute the update command to regenerate diagrams and refresh the PRD frontmatter with new diagram hashes.

What is the best way to create a structured PRD for different project types like a CLI or service?▼

The best way to create structured PRDs for services, libraries, or CLIs is using automated scaffolding. The Skill detects your specific project type and generates a Project Requirement Document with appropriately tailored sections.

Does PRD generation validate section limits and frontmatter completeness?▼

Yes, PRD generation includes built-in validation that enforces section limits and verifies frontmatter completeness. This ensures your Project Requirement Documents maintain consistent structure and required metadata across updates.

Why do I need inline code annotations for maintaining project documentation?▼

Inline code annotations are needed to keep documentation synchronized with your codebase. By embedding `@prd_flow` and `@prd_step` tags directly in Python, Bash, or YAML files, you automate diagram creation and eliminate manual documentation drift.

Related Skills

Explore More Product & Management Skills→
ilandahanilandahan
9

role-product-manager

Guide product discovery, PRD creation, and phase-specific deliverables.

Community
Basic
antoinebou12antoinebou12
92

uml-diagramming

Generate Mermaid or PlantUML diagram code from text specifications.

Community
Intermediate
abudhahirabudhahir

senior-architect

Generate architecture diagrams and analyze dependencies for software systems.

Community
Advanced
OpenWaggleOpenWaggle
4

to-prd

Analyzes code repositories to generate structured project requirement documents.

Official
Advanced