design

Create and maintain a repo-local DESIGN.md for UI/UX decisions.

Updated May 25, 2026
One-click install
npx skills add https://github.com/BetaS/swm-gis-workshop --skill design-betas
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: design
Source: https://github.com/BetaS/swm-gis-workshop/tree/main/.codex/skills/design
Command: npx skills add https://github.com/BetaS/swm-gis-workshop --skill design-betas

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

The design Skill addresses the challenge of keeping design information centralized, actionable, and easily accessible within the repository.

Core Features & Use Cases

  • Repo Design Contract: Ensures a durable source of truth for product, UI/UX, frontend, and design-system decisions.
  • Workflow Guidance: Provides step-by-step instructions to discover, interview, create/refresh DESIGN.md, and utilize it as a decision contract.
  • Integration: Complements with $visual-ralph for implementation and visual verification workflows.

Quick Start

Activate the design Skill by typing $design.

Frequently Asked Questions about design

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

FAQPage Schema
How do I maintain a centralized UI/UX design contract within my repository?

You can maintain a centralized UI/UX design contract by creating a repo-local DESIGN.md file that serves as a durable source of truth for product and frontend decisions. The design Skill provides a workflow to establish and refresh this document.

What is the best way to document design-system decisions for frontend development?

Documenting design-system decisions requires a maintained source of truth like a DESIGN.md file. This approach integrates design considerations directly into the product development lifecycle, ensuring frontend decisions remain actionable and easily accessible.

How do I integrate design considerations into a software development workflow?

You integrate design considerations by following a step-by-step decision-making process to discover, interview, and create a DESIGN.md file. This contract is then utilized alongside implementation workflows like visual verification to guide development.

Does the design Skill work with visual verification workflows?

Yes, the design Skill complements visual verification workflows. It provides the DESIGN.md decision contract that pairs with related implementation workflows, such as visual-ralph, to execute and verify UI/UX frontend work.

When do I need a repo-local DESIGN.md file for my frontend project?

You need a repo-local DESIGN.md file when your repository requires a comprehensive, maintained source of truth for UI/UX and frontend work. It solves the challenge of keeping design information centralized and actionable.

Can I use this approach for design-system decision-making without external dependencies?

Yes, this approach operates entirely repo-local with no external dependencies. It provides a self-contained decision-making process to help you discover requirements and maintain your design system documentation.