archflow-agent-dsl-generator

Converts wireframes into styled, platform-neutral YAML component specifications.

28|4|Updated Mar 12, 2026
One-click install
npx skills add https://github.com/AZidan/archflow --skill archflow-agent-dsl-generator-azidan
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: archflow-agent-dsl-generator
Source: https://github.com/AZidan/archflow/tree/main/adapters/generic/.agents/skills/archflow-agent-dsl-generator
Command: npx skills add https://github.com/AZidan/archflow --skill archflow-agent-dsl-generator-azidan

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Turning visual designs into implementation-ready component specs is error-prone: frontend and backend drift apart, styling values get hardcoded, and design system names get replaced with generic terms. This Skill converts wireframes and mockups into a single styled DSL file that hi-fi design, API contract, and UI engineering phases all read from, keeping every downstream artifact consistent. ## Core Features & Use Cases - Two-phase generation: First extract a layout-only component hierarchy from wireframes, then merge it with the project's theme tokens to produce a fully styled DSL. - Design system enforcement: Every component name comes from the design system's vocabulary table and every color is a semantic theme token; raw palette steps and hex literals are rejected, and missing components are logged in component-gaps.md instead of invented. - Platform-neutral output: The emitted YAML describes structure, semantics, and styling intent without framework syntax, so one file can be translated into both web and mobile implementations. - Use Case: After the ux-designer produces wireframes in Phase 2, run this role to generate design-artifacts/styled-dsl.yaml, which Phase 2.25 hi-fi screens, the Phase 2.5 API contract, and the ui-engineer in Phase 3 all consume as the source of truth. ## Quick Start Ask the agent to convert the approved wireframes into design-artifacts/styled-dsl.yaml using the project's design system and theme tokens.

Frequently Asked Questions about archflow-agent-dsl-generator

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

FAQPage Schema
How do I convert wireframes into a component specification file?

Run the dsl-generator role after the ux-designer phase. It analyzes the wireframes, maps visual elements to components from the design system's vocabulary table, and writes the result to design-artifacts/styled-dsl.yaml for downstream phases.

What is a styled DSL in a design-to-code workflow?

A styled DSL is a YAML file describing screen structure, component hierarchy, and styling intent using semantic theme tokens rather than framework syntax. It stays platform-neutral so ui-engineer can translate one file into web or mobile code.

Can the generated DSL target both web and mobile platforms?

Yes, the DSL is platform-neutral by design and must be translatable into every platform listed in the project stack. If a screen genuinely diverges between web and mobile, the difference is documented explicitly in the file.

What happens if the design system lacks a needed component?

The missing component is composed from the design system's primitives and recorded in design-artifacts/component-gaps.md with the reason. New component names or raw palette colors are never silently invented.

Why does the DSL generator stop when design-system.yaml is missing?

Without a design system there is no authoritative component vocabulary or token set, so any output would be guesswork. The role halts and instructs the user to run the archflow-design step first on projects with a UI.