AgentSkillsCN

design-system-analyzer

使用ChromeDevTools分析任何网站的UI风格,提取精确的CSS标记、动画和交互状态。通过引导用户处理复杂站点和反机器人措施。触发条件包括“分析此网站”、“提取UI风格”、“从[URL]创建设计系统”或“学习视觉风格”。

SKILL.md
--- frontmatter
name: design-system-analyzer
description: Analyze any website's UI style using ChromeDevTools to extract precise CSS tokens, animations, and interaction states. Handles complex sites and anti-bot measures by guiding the user. Triggers on "analyze this site", "extract UI style", "create design system from [URL]", or "learn visual style".

Design System Analyzer

Analyze websites via ChromeDevTools to extract deep CSS logic (keyframes, transitions, tokens) and generate comprehensive Design System System Prompts.

Critical Rules

  1. MUST output the final prompt using EXACTLY the structure in references/design-system-template.md
  2. MUST limit extraction data to prevent context overflow (see analysis-guide.md for limits)
  3. MUST fill ALL template placeholders with extracted or observed values
  4. NEVER skip sections - use "Not observed" if data unavailable

Best Practice: Use Your Own Chrome

For the best experience (no CAPTCHAs, shared login cookies), advise the user to run Chrome with: chrome.exe --remote-debugging-port=9222 (See references/setup-guide.md for details)


Workflow Overview

code
[1. Navigate] → [2. Anti-Bot Check] → [3. Deep Extraction] → [4. Synthesize to Template]

IMPORTANT: Do NOT take screenshots. Screenshots consume excessive context and are unnecessary - all visual data is extracted from CSS.


Step 1: Navigate & Anti-Bot Check

code
mcp__chrome-devtools__navigate_page (url: "<target-url>")

Immediately check for bot challenges:

javascript
() => {
  const text = document.body.innerText.toLowerCase();
  const title = document.title.toLowerCase();
  if (text.includes('cloudflare') || text.includes('verify you are human') || title.includes('just a moment')) {
    return 'CHALLENGE_DETECTED';
  }
  return 'OK';
}

IF CHALLENGE_DETECTED:

  1. PAUSE all actions.
  2. Tell the user: "Bot protection detected. Please manually solve the CAPTCHA in the browser, then confirm here."
  3. Wait for user confirmation before proceeding.

Step 2: Deep CSS Extraction

Run the extraction scripts from references/analysis-guide.md in order:

OrderScriptPurposeMax Items
1CSS Variables & TokensColors, spacing, typography variables50 tokens
2Animation & Keyframes@keyframes, animation usage, transitions10 KF, 15 trans
3Interaction States:hover, :focus, :active rules15 rules
4TypographyFont stacks from key elements7 elements
5Layout & SpacingBorder radius, gaps, shadows5 each
6Tech StackFramework detection-

IMPORTANT: Each script has built-in limits. Do NOT modify to extract more data.


Step 3: Synthesize to Template

MANDATORY: Generate output using EXACTLY the template structure from references/design-system-template.md.

Template Mapping Table

Extracted DataTemplate SectionNotes
tokens.colorsDesign Token System > ColorsFormat as table
tokens.spacingSpacing, Radius & BordersInclude radius values
tokens.typographyTypographyInclude font stacks
Typography scriptTypography > Font Stacks, Type ScaleComputed styles
keyframesAnimation & Motion > Key AnimationsFull keyframe definitions
animationUsageAnimation & Motion > TimingDuration, easing
transitionsAnimation & Motion > TimingCommon patterns
interactionsComponent Styling > State TransitionsHover/focus effects
Layout samplerLayout PrinciplesSpacing system
Tech stackImplementation NotesTailwind/CSS notes

Output Format Checklist

Before outputting, verify ALL these sections are present:

  • <role> block (copy exactly from template)
  • <design-system> wrapper
  • ## Design Philosophy with Core Principles, Vibe, Historical Context
  • ## Design Token System with Colors table, Typography, Spacing
  • ## Component Styling Principles with Buttons, Cards, Form Inputs
  • ## Layout Principles with Spacing System, Grid, Responsive
  • ## The "Signature" Factor with 3 mandatory elements
  • ## Animation & Motion with Philosophy, Timing, Key Animations
  • ## Accessibility Constraints
  • ## Anti-Patterns with Visual and Interaction no-nos
  • ## Implementation Notes with tech-specific guidance
  • ## Aesthetic Checklist with 4 verification items
  • Closing </design-system>

Resources