Prd to appspec

Skill bg-szy/TOP-SKILLS/skills/marketplace/prd-to-appspec

Transform PRDs (Product Requirements Documents) into structured XML app specifications optimized for AI coding agents. Converts developer-focused docs with code examples into declarative agent-consumable format. USE WHEN user says "convert PRD", "generate app spec", "transform PRD", "create specification from requirements", or wants to prepare a PRD for agent consumption.From its SKILL.md

Install

npx -y skills add bg-szy/TOP-SKILLS --skill prd-to-appspec

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

2 things to look at

no licenseNo license file was found in the repository. Code published without one is not open source by default, so using it at work is a question for whoever answers licensing questions where you are.
5 stars5 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

SKILL.md

2.6 KB, 461 tokens by cl100k_base, as published. Nobody here has run it

PRD to App Spec Converter

Transform Product Requirements Documents (PRDs) into structured XML application specifications optimized for AI coding agents.

When to Activate This Skill

Convert a PRD to app spec format
Generate XML specification from requirements document
Transform technical PRD for agent consumption
Prepare documentation for AI coding agent
Create app_spec.txt from existing PRD

What This Skill Does

Converts developer-focused PRDs (with code snippets, TDD plans, implementation details) into declarative XML specifications that AI coding agents can consume more effectively.

Input: PRD with technical details, code examples, architecture decisions Output: Structured app_spec.txt in XML format

How to Execute

Run the /convert-prd workflow, which provides:

PRD file location (prompts if not provided)
Section-by-section extraction and transformation
Pydantic models → database schema conversion
Implementation code → feature descriptions
Epics/tasks → numbered implementation steps
Test assertions → success criteria
Final XML output with validation

Core Transformations

PRD Has	App Spec Gets
Function implementations	Feature descriptions
Pydantic field validators	Data constraints in prose
Try/except patterns	Error handling requirements
Test assertions	Success criteria
CLI commands	API/command summaries
Directory structure	Technology stack context

Output Template Structure

<project_specification>
  <project_name>...</project_name>
  <overview>...</overview>
  <technology_stack>...</technology_stack>
  <core_features>...</core_features>
  <database_schema>...</database_schema>
  <api_endpoints_summary>...</api_endpoints_summary>
  <implementation_steps>...</implementation_steps>
  <success_criteria>...</success_criteria>
</project_specification>

Key Principle

PRD: Shows HOW (implementation details)
App Spec: Describes WHAT (requirements and expectations)

The app_spec tells an agent WHAT to build without dictating exact implementation.

Full Workflow Reference

For complete step-by-step instructions: workflows/convert-prd.md

What ships with it: 2 files

26.1 KB alongside SKILL.md

skill-report.json17.6 KB
SKILL-v2.md8.5 KB