idea-to-pdd-eval

Grade Product Design Documents against source idea packs and output verdict YAML.

1|2|Updated Apr 1, 2026
One-click install
npx skills add https://github.com/dimagi-internal/ace --skill idea-to-pdd-eval
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: idea-to-pdd-eval
Source: https://github.com/dimagi-internal/ace/tree/main/skills/idea-to-pdd-eval
Command: npx skills add https://github.com/dimagi-internal/ace --skill idea-to-pdd-eval

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The built-in self-evaluation for Product Design Documents (PDDs) has critical blind spots: the same AI model that writes the PDD also grades it, leading to over-generosity bias, and it only checks the PDD against its own rubric rather than the original source idea pack. This means PDDs that miss reviewer comments from the source material or silently resolve source conflicts can still earn perfect self-graded scores, leading to low-quality designs moving forward in the ACE lifecycle.

Core Features & Use Cases

  • Unbiased Independent Grading: Re-runs stress tests from outside the PDD authoring process to eliminate over-generosity bias from the self-eval.
  • Source Pack Cross-Check: Validates the PDD against the full original source idea pack to catch missed reviewer comments, unaddressed concerns, and silently resolved source conflicts.
  • Weighted Quality & Viability Scoring: Grades PDDs across 9 weighted dimensions covering document fidelity, program viability, demand reality, and mission alignment, then outputs a structured verdict YAML for auditability.
  • Use Case: For ACE Connect opportunity design teams, run this skill immediately after generating a PDD to identify gaps, flag integrity issues, and ensure the design is grounded in the original source material before moving to implementation.

Quick Start

Use the idea-to-pdd-eval skill to grade the PDD for your current Connect opportunity against its source idea pack and generate a structured quality verdict.

Frequently Asked Questions about idea-to-pdd-eval

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

FAQPage Schema
How do I evaluate a Product Design Document against its original source idea pack?

Evaluating a Product Design Document against its original source idea pack requires cross-checking reviewer comment fidelity and source conflict honesty to eliminate over-generosity bias from self-evaluations. This process generates a structured verdict YAML with weighted dimension scores and auto-surfaced warnings.

Why does my PDD self-evaluation give perfect scores despite missing reviewer comments?

PDD self-evaluation over-generosity bias happens when the same AI model authors and grades the document, ignoring original source material. An independent grading process re-runs stress tests from outside the authoring workflow to catch missed reviewer comments and silently resolved source conflicts.

How do I detect silent source conflicts in ACE Connect opportunity design workflows?

Detecting silent source conflicts in ACE Connect opportunity design workflows involves cross-checking PDD content against the full original source idea pack. This independent validation flags unaddressed concerns and integrity issues that self-evaluations often miss.

Can I independently grade PDDs across weighted quality and viability dimensions?

Independently grading PDDs across weighted quality and viability dimensions is possible by assessing document fidelity, program viability, demand reality, and mission alignment. This produces a structured quality verdict YAML with calibration signals for self-eval rubric accuracy.

When should I run an independent PDD evaluation in the ACE lifecycle?

Run an independent PDD evaluation immediately after generating the document and before moving to implementation. This ensures the design is grounded in the original source material and identifies gaps or integrity issues early in the ACE lifecycle.

What is idea-to-pdd-eval and does it require any external dependencies?

Idea-to-pdd-eval is an independent PDD grading skill for ACE Connect workflows that requires no external dependencies. It validates PDD content against source idea packs to output a structured verdict YAML with weighted scores and auto-surfaced warnings.