plumbeer-design-reviewer

Review design docs against a 24-item checklist and produce a readiness matrix.

Updated Mar 22, 2026
One-click install
npx skills add https://github.com/marioplumbeer/skills --skill plumbeer-design-reviewer-marioplumbeer
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: plumbeer-design-reviewer
Source: https://github.com/marioplumbeer/skills/tree/main/.agents/skills/plumbeer-design-reviewer
Command: npx skills add https://github.com/marioplumbeer/skills --skill plumbeer-design-reviewer-marioplumbeer

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Design docs often reach org-wide review with missing goals, weak non-goal rationales, or single-solution thinking, causing costly rewrites. This Skill grades any design doc against a canonical 24-item Design Doc Review Checklist and returns a readiness matrix showing exactly what is met, partial, missing, or not applicable. ## Core Features & Use Cases - Checklist-Based Grading: Evaluates all 24 rows of the canonical checklist, assigning each a Status (Met, Partial, Not Met, N/A) grounded in quoted evidence from the document. - Actionable Next Steps: For every gap, writes a concrete, document-specific recommendation rather than generic advice like "add more detail". - Flexible Input: Accepts the design doc as pasted text, a local file, or an external link (Notion via notion-fetch, Google Docs or other URLs via WebFetch). - Use Case: Paste a draft high-level design and ask "is this ready for org-wide review?" to receive a full readiness matrix with a one-line rollup of the biggest gaps. ## Quick Start Review my design doc at this link against the design review checklist and tell me what is missing before org-wide review.

Frequently Asked Questions about plumbeer-design-reviewer

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

FAQPage Schema
How do I review a design doc against a checklist?▼

Provide the design doc as pasted text, a local file path, or a link, and the Skill evaluates it against all 24 rows of the canonical checklist. You receive a readiness matrix with a Status and Recommended Next Step for every row.

Can I review a design doc stored in Notion or Google Docs?▼

Yes, external links are supported. Notion URLs are fetched with notion-fetch, and Google Doc export links or other URLs are retrieved with WebFetch before the review begins.

What does the design doc readiness matrix contain?▼

The matrix keeps all six original checklist columns and adds Status (Met, Partial, Not Met, or N/A) plus a Recommended Next Step for each of the 24 rows. A one-line rollup summarizes the biggest gaps before the table.

Why are some checklist rows marked N/A during review?▼

Rows 8-10 and 16-23 describe review process steps like meetings held and blockers assigned, which a standalone document usually cannot prove. These default to N/A unless the doc includes its own review history or the user states the review status.

Does the design reviewer edit or write back to my document?▼

No, the Skill only reads the document and prints the readiness matrix. It never writes back to Notion or modifies any file; saving the matrix elsewhere is a separate follow-up request.