masluny

Design Scout — AI skill for Claude Code

AI community

Research-first UI/UX design for AI coding agents (Claude Code, Codex, Cursor): reads expert sources with verified quotes, measures professional sites, designs with modern effects like Paper Shaders, a.

How to install Design Scout

This entry records only its repository, not the path inside it, so there is no exact command to give. Open masluny/design-scout and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Design Scout does

Research-first UI/UX design for AI coding agents (Claude Code, Codex, Cursor): reads expert sources with verified quotes, measures professional sites, designs with modern effects like Paper Shaders, audits until it passes.

Alternatives in AI

  • Omniget — Udemy & Hotmart course downloader, YouTube downloader (yt-dlp GUI, 1,800+ sites) + desktop app for AI agents 13.9k ★
  • AGENTS.md - Skill Seekers — Concise reference for AI coding agents 11.1k ★
  • Cursor Talk To Figma MCP — TalkToFigma: MCP integration between AI Agent (Cursor, Claude Code, Codex) and Figma, allowing Agentic AI to c 7k ★

README

design-scout

Research-first UI/UX design for AI coding agents (Claude Code, Codex, Cursor).

Ask an agent to "make it look professional" and it designs from memory: stock indigo gradients, three identical feature cards, Inter everywhere. design-scout makes the agent work the way a good designer does:

  1. Read the experts. Curated sources (NN/g, Baymard, WCAG, web.dev, Butterick, Utopia, Apple HIG, Material, GOV.UK, Vercel's interface guidelines...) ranked by evidence. Every principle the agent uses is recorded with a quote that is checked against the live page.
  2. Study professional sites. capture opens real sites in Chromium, takes desktop and mobile screenshots, and measures what they actually use: fonts, type scale ratio, palette by screen area, spacing grid, radii, content width, CTAs, modern CSS features and effect libraries (GSAP, Lenis, three.js, Paper Shaders, Unicorn Studio...).
  3. Decide with reasons. A direction.md where every decision points to a principle or a reference, fluid type/space tokens (clamp()), and a contrast matrix for every color pair.
  4. Add one considered modern effect. A catalog of 28 effects with verified snippets, licenses, accessibility and performance notes: Paper Shaders, Unicorn Studio, ShaderGradient, GSAP, Motion, Lenis, React Bits, Magic UI, Aceternity UI, Rive, View Transitions and more.
  5. Audit until it passes. Contrast measured on the real pixels behind each text box (works over gradients and shaders), touch targets, focus visibility, reduced motion, mobile overflow, line length, type-scale drift, and more.
  6. Hand over a dossier. One HTML page with the brief, principles, reference moodboard, comparison, direction, tokens, effects and audit.

The agent makes the design judgments; the CLI does everything that should be objective.

Install

git clone https://github.com/masluny/design-scout && cd design-scout
pip install -e ".[capture]"
python -m playw