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.