design-spec-extraction

Converts graphic design inputs into JSON specs via tiered AI processing.

1|Updated Mar 27, 2026
One-click install
npx skills add https://github.com/leonanpereirapinto/ai-utils --skill design-spec-extraction-leonanpereirapinto
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: design-spec-extraction
Source: https://github.com/leonanpereirapinto/ai-utils/tree/main/skills/spec-driven/design-spec-extraction
Command: npx skills add https://github.com/leonanpereirapinto/ai-utils --skill design-spec-extraction-leonanpereirapinto

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill enables turning visual design inputs (screenshots, mockups, or design exports) into production-ready JSON design specifications, accelerating handoff to engineering and design systems.

Core Features & Use Cases

  • Produce a comprehensive design specification including tokens, component trees, accessibility analysis, and developer handoff artifacts.
  • Operate with a deterministic, multi-pass architecture that ensures complete coverage and traceability.
  • Support audit-ready outputs and machine-readable extensions for integration with design tooling and CI pipelines.

Quick Start

Provide a visual design input to generate a complete production-ready design-spec.json.

Frequently Asked Questions about design-spec-extraction

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

FAQPage Schema
How do I extract design specs from a screenshot for developer handoff?

You can extract design specs from screenshots by processing visual inputs through a 7-pass serial architecture that generates tokens, component trees, and accessibility analysis. This produces a deterministic design-spec.json file ready for developer handoff.

What is the best way to generate design tokens from a mockup?

Generating design tokens from mockups is best handled by a multi-pass extraction architecture that cross-validates visual inputs. This approach produces production-ready JSON specifications including token definitions and component trees for system integration.

Can I use design spec extraction for accessibility analysis of design exports?

Yes, design spec extraction supports accessibility analysis by processing design exports through its serial architecture. It evaluates visual inputs and includes accessibility findings directly within the final JSON design specification output.

Does design spec extraction produce machine-readable outputs for CI pipelines?

Design spec extraction produces deterministic, machine-readable JSON outputs written to disk during each pass. These audit-ready artifacts are designed for integration with design tooling and CI pipelines to automate handoff.

How do I turn visual design exports into a component tree?

Turning visual design exports into a component tree requires a multi-pass cross-validation process that analyzes the mockup structure. The extraction architecture maps visual elements into a structured JSON component tree for engineering handoff.

What are the limitations of automated design spec extraction from screenshots?

Automated design spec extraction requires clear visual inputs to accurately generate tokens and accessibility analysis. While the 7-pass architecture ensures traceability, complex or ambiguous screenshots may produce less deterministic JSON outputs for handoff.