pp-doctor

Inspects Figma design files for naming, layout, structure, and asset issues before code generation.

4|Updated Aug 4, 2026
One-click install
npx skills add https://github.com/double-coding-lab/PixelPrint --skill pp-doctor-double-coding-lab
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: pp-doctor
Source: https://github.com/double-coding-lab/PixelPrint/tree/main/templates/skills/pp-doctor
Command: npx skills add https://github.com/double-coding-lab/PixelPrint --skill pp-doctor-double-coding-lab

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Design-to-code pipelines fail silently when Figma files have inconsistent layer naming, missing Auto Layout, conflicting prefixes, or oversized node trees. This Skill runs a pre-generation health check on a Figma design so problems are caught and fixed before any code is produced. ## Core Features & Use Cases - Rule-based layer scanning: Runs 30+ checks (NAM/LAY/STR/AST/FEA/IMG/SUB/CLR/DIM/BGP rules) covering prefix naming, Auto Layout usage, nesting depth, duplicate names, and asset exportability. - Fidelity incident detection: Catches sub-agent merge and slicing errors such as lost data-node-ids, unreferenced sliced images, wrong text colors, and incorrect minHeight/paddingTop sources. - Actionable reports: Emits Markdown and JSON health reports with per-issue severity, owner (designer/developer), fix instructions, and direct Figma node links. - Use Case: Before converting a Figma marketing page to React code, run the health check to discover that a bg- layer should be bgc-, two sibling layers share a name, and a btn- node contains an un-ignored TEXT layer that would cause double-rendered text. ## Quick Start Paste a Figma design URL and ask the agent to run a health check on the design before generating code.

Frequently Asked Questions about pp-doctor

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

FAQPage Schema
How do I check if a Figma design is ready for design-to-code conversion?▼

Provide the Figma URL with a node-id and ask for a health check. The skill fetches the layer tree via the Figma REST API, tags every node with prefix and layout attributes, then runs naming, layout, structure, and asset rules, outputting a report with fixes.

What Figma layer naming conventions does the health check validate?▼

It validates prefixes like sub-, block-, img-, bg-, bgc-, btn-, fixed-, end-, input-, scrollx-, scrolly-, and x-. It flags misspellings, conflicting prefix combinations, missing separators, and modifier prefixes stacked on node-less prefixes like bg- or x-.

Does the Figma health check require an MCP plugin or OAuth?▼

No. All Figma data is read through a figma.mjs script that calls the REST API directly with a personal access token from the project .env file. A verify-token probe runs first and stops the flow with diagnostics if the token is invalid.

What happens when a Figma file has too many layers for the health check?▼

If the fetched subtree exceeds 5000 nodes the check terminates immediately with advice to select a smaller frame. Between 1500 and 5000 nodes it continues but records an oversize warning that surfaces as a FEA003 issue in the report.

Can the health check detect code generation fidelity errors?▼

Yes. Rules like SUB027, IMG028, CLR030, DIM031, and BGP033 detect incidents where merged output lost sub-agent data-node-ids, sliced images went unreferenced, text colors mismatched Figma fills, or dimensions came from the wrong source node.