psd2code-next

Analyzes PSD/PSB website designs and exports per-section image assets via a local CLI.

1|Updated Sep 1, 2026
One-click install
npx skills add https://github.com/yinsheng1026/psd2code-next --skill psd2code-next-yinsheng1026
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: psd2code-next
Source: https://github.com/yinsheng1026/psd2code-next/tree/main/skills/psd2code-next
Command: npx skills add https://github.com/yinsheng1026/psd2code-next --skill psd2code-next-yinsheng1026

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Converting PSD/PSB desktop website design files into front-end code requires manual inspection of fonts, sections, and image assets, which is error-prone and hard to verify. This Skill coordinates an AI agent with a deterministic local CLI to extract facts, confirm decisions with the developer, and export section-by-section assets. ## Core Features & Use Cases - Deterministic PSD Analysis: Runs preflight, font extraction, and section detection using real Photoshop Artboard boundaries, with a controlled 1920x1080 grid fallback only after explicit developer approval. - Progressive Section Workflow: Processes one section at a time with a cursor, persisting pending decisions in decisions.json and only disclosing questions for the current section. - Design Screenshot Management: Tracks per-section reference screenshots with SHA-256 verified persistence and strict origin rules (chat-attachment or user-provided-path only). - Use Case: A developer receives a PSD homepage design and asks the AI agent to analyze it; the agent runs the CLI, confirms font tokens and section interactions through a structured table, then exports cropped assets per section for implementation. ## Quick Start Ask the AI agent to analyze your PSD file with the psd2code-next skill, for example: "Use psd2code-next to analyze homepage.psd and start exporting the first section."

Frequently Asked Questions about psd2code-next

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

FAQPage Schema
How do I convert a PSD design file into front-end code sections?

Run the CLI init command with the PSD path, then preflight and analyze to extract fonts and detect sections from Photoshop Artboards. Each section is exported with export-section after the developer confirms decisions through a structured table.

How does PSD section detection work with Photoshop Artboards?

Valid top-level Artboards are used automatically with their real boundaries, and artboards overlapping vertically by at least 80 percent are grouped into one section. The fixed 1920x1080 grid is only a fallback requiring explicit developer approval when Artboards are missing or invalid.

What are the requirements to run the psd2code-next CLI?

The CLI requires Node.js 20 or later and is installed by cloning the repository into tools/psd2code-next and running npm ci. The AI agent host must support non-interactive command execution and filesystem access.

Can the tool guess section interactions from PSD layer names?

No. Layer names are stored only as low-confidence hints in nameFacts and nameHints. All interactions, default states, and section semantics must be confirmed by the developer through the unified confirmation table.

Why does the skill reject screenshots from Downloads or exported images?

Only original user chat attachments or explicitly user-provided file paths are accepted as design references, verified by SHA-256 and file signature. Substitute sources like exported rasters, similar images, or browser screenshots are forbidden to prevent visual mismatches.