forge-design

Translates design references and screenshots into iOS-native .forge/DESIGN.md contracts for Forge templates.

1|Updated Feb 20, 2026
One-click install
npx skills add https://github.com/sakhnenkoff/forge-ios --skill forge-design
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: forge-design
Source: https://github.com/sakhnenkoff/forge-ios/tree/main/skills/forge-design
Command: npx skills add https://github.com/sakhnenkoff/forge-ios --skill forge-design

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Translates design references (awesome-design-md, user screenshots, and axis presets) into an iOS-native DESIGN.md contract for the Forge template, enabling a cohesive design contract without manual drafting.

Core Features & Use Cases

  • Converts reference inputs from .forge/references (index.md and *.md) and reference screenshots into a DESIGN.md contract that Forge can use.
  • Applies color, typography, spacing, radius, and component mappings to ensure an iOS design contract aligned with the Forge design system.
  • Use Case: design teams collect references and presets to automatically generate a ready-to-use DESIGN.md for sprint planning.

Quick Start

Provide input references in .forge/references and run the forge-design skill to generate .forge/DESIGN.md.

Frequently Asked Questions about forge-design

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

FAQPage Schema
How do I generate a design contract from reference screenshots for iOS?▼

To generate an iOS design contract from reference screenshots, place your images and preset files in the .forge/references directory. The skill translates these visual references into a native DESIGN.md file, applying color, typography, and spacing mappings automatically.

What is a DESIGN.md file and when do I need it for iOS development?▼

A DESIGN.md file is a structured design contract that defines color, typography, spacing, radius, and component rules for iOS development. You need it when establishing a cohesive design system to ensure consistent UI implementation across your application.

Can I use markdown references to create an iOS design system?▼

Yes, you can use markdown references to create an iOS design system by placing index.md and related .md files into the .forge/references folder. The skill parses these documents and translates the specifications into a structured DESIGN.md contract.

How do I translate awesome-design-md references into a Forge template contract?▼

To translate awesome-design-md references into a Forge template contract, input the reference files and run the translation skill. It applies predefined rules for color, typography, spacing, and components to output a consistent DESIGN.md file in the .forge directory.

Does the Forge design translation support custom spec.json configurations?▼

Yes, the Forge design translation supports custom spec.json configurations. By combining your spec.json with reference screenshots and axis presets, the skill applies customized translation rules to produce a DESIGN.md contract tailored to your specific design requirements.

Why is my generated DESIGN.md missing component mappings?▼

Your generated DESIGN.md may be missing component mappings if the input references in .forge/references lack sufficient detail. Ensure your index.md, screenshots, or spec.json files clearly define the required components to trigger accurate translation rules.