Xialiang98 GitHub avatar

design-visual-frontend

Xialiang98

Design Visual Frontend is an agent skill that guides AI coding agents to systematically design, implement, and visually verify frontend interfaces with a focus on task hierarchy, content truth, responsiveness, and accessibility.

Stars

15

7-day growth

No data

Forks

0

Open issues

0

License

MIT

Last updated

2026-07-12

AI repository intelligence
FR-AI / ANALYSIS

Why it is worth attention

It transforms how AI agents approach frontend work by replacing generic template styling with a structured reasoning process that classifies interface types, defines visual hierarchy, grounds design in real content, and enforces non-compensating quality gates, effectively preventing common AI-generated UI anti-patterns.

Who it is for

  • AI coding agents like Codex and Claude Code
  • developers using AI tools for frontend work
  • UX designers collaborating with AI agents
  • engineering teams standardizing AI-generated UI quality

Use cases

  • Building task-led web pages and forms with proper hierarchy
  • Redesigning existing interfaces to remove generic template patterns
  • Conducting visual UI reviews with evidence-based findings
  • Implementing and verifying responsive layouts across multiple viewports

Strengths

  • Structured decision sheet for hierarchy, composition, and tokens before implementation
  • Explicit non-compensating review gates preventing attractive-but-broken UI
  • Requires explicit mobile, tablet, desktop, wide, and ultra-wide behavior
  • Uses browser screenshots and interaction checks when available for visual evidence

Considerations

  • Improves agent process but does not replace product requirements, real assets, or domain expertise
  • Visual verification requires browser tooling availability in the host environment
  • Does not ship UI components, fonts, images, or runtime dependencies
  • Host tool discovery and invocation differences may require manual setup

README quick start

Design Visual Frontend

design-visual-frontend is an Agent Skill for designing, implementing, redesigning, and reviewing frontend interfaces. It helps coding agents move beyond generic template styling by making them reason about the product's real subject, user task, composition, responsive behavior, content truth, accessibility, and rendered visual evidence.

The Skill can be used with Codex, Claude Code, and other tools that support the open SKILL.md-based Agent Skills format.

What It Does

  • Classifies the interface as task-led, command-led, inspection-led, narrative-led, reading-led, or conversion-led.
  • Defines the visual hierarchy before implementation through a compact decision sheet.
  • Grounds the design in real product content, workflows, assets, and domain conventions.
  • Prevents common AI-generated UI patterns such as empty split screens, decorative card grids, fake metrics, oversized headings, and stacked visual effects.
  • Establishes reusable rules for typography, color roles, spacing, surfaces, controls, states, and motion.
  • Requires explicit mobile, tablet, desktop, wide, and ultra-wide behavior.
  • Reviews accessibility, loading/error/empty states, keyboard focus, touch targets, reduced motion, and engineering integrity.
  • Uses browser screenshots and interaction checks when browser tooling is available, while clearly reporting when visual verification was not possible.

When To Use It

Use this Skill for:

  • websites and landing pages;
  • login, signup, checkout, booking, search, and form flows;
  • dashboards, admin tools, monitors, editors, and operational consoles;
  • product pages, portfolios, publications, and content-heavy experiences;
  • frontend redesigns and anti-template visual improvements;
  • visual UI reviews that need concrete, evidence-based findings;
  • responsive implementation and browser-based quality verification.

How It Works

The repository is not a component library or a fixed visual theme. It is a structured reasoning system for an AI coding agent.

  1. SKILL.md defines when the Skill should activate and the workflow the agent must follow.
  2. The agent inspects the request, codebase, stack, assets, and available browser tools.
  3. It identifies the dominant surface archetype and the interface's true protagonist.
  4. It creates a compact design decision sheet covering hierarchy, cont

Description

Agent Skill for distinctive frontend design, responsive implementation, visual review, and browser-verified UI quality.

Related repositories

Similar projects matched by category, topics, and programming language.

Vincentwei1021
Vincentwei1021 GitHub avatar

video-shotcraft

An AI agent skill that turns Claude Code or Codex into a motion-design studio for crafting cinematic product videos with Remotion, offering 106 shot recipe cards, 162 styles, 161 motion previews, and a production-ready template.

TypeScript
2,432
makecindy
Featured
makecindy GitHub avatar

cindy

Cindy is an open-source AI agent that runs locally on your machine, integrates multiple AI harnesses and models, and provides memory, skills, and automation to perform real work in your projects and apps.

AI & Machine LearningLarge Language Models
958
0xwilliamortiz
Featured
0xwilliamortiz GitHub avatar

ponytail-improved

Ponytail is a plugin for AI coding agents that enforces a disciplined ladder of reuse before writing code, reducing code volume by roughly 54% while preserving safety.

AI & Machine LearningAI Agents
545