ui-preview

Preview and screenshot local dev servers and storybooks. Use when asked to view UI components, take screenshots of storybooks, or inspect the web/server apps.

⭐30stars🔀9forks📁View on GitHub🕐Updated Jan 8, 2026⬇️1downloads

When & Why to Use This Skill

The UI Preview skill enables Claude to interact directly with local development servers and Storybook environments. By leveraging Chrome DevTools, it allows for seamless navigation, high-resolution screen capturing, and deep inspection of UI components. This skill bridges the gap between code generation and visual verification, making it an essential tool for front-end developers to debug layouts, verify component states, and audit accessibility trees in real-time.

Use Cases

  • Visual Regression Testing: Automatically navigate through Storybook stories and capture screenshots to identify unintended UI changes during the development cycle.
  • UI/UX Component Inspection: Use the accessibility tree snapshot tool to analyze element UIDs and verify that complex components like 'streaming-thread' or 'diff-viewer' are rendering correctly.
  • Automated Interaction Debugging: Simulate user actions such as clicking buttons and filling forms on local dev servers (e.g., localhost:7001) to test functional workflows without leaving the chat interface.
  • Documentation & Handoff: Generate visual previews of specific UI states, such as error modals or loading indicators, to provide clear visual context for technical documentation or team handoffs.
nameui-preview
description'Preview and screenshot local dev servers and storybooks. Use when asked to view UI components, take screenshots of storybooks, or inspect the web/server apps.'
version'1'

UI Preview Skill

Preview local dev servers and storybooks using Chrome DevTools.

Available Tools

  • navigate_page - Navigate to a URL
  • take_screenshot - Capture a screenshot of the current page
  • take_snapshot - Get a text snapshot of the page (a11y tree with element UIDs)
  • click - Click on an element by UID
  • fill - Type text into an input field
  • new_page - Open a new browser tab
  • list_pages - List open browser tabs

Workflow

  1. Navigate to the target URL using navigate_page
  2. Screenshot the page using take_screenshot
  3. Analyze captured screenshots with look_at for visual analysis

Local Dev URLs

Service URL
Web dev server http://localhost:7001
Server dev server https://localhost:7002
Webview storybook http://localhost:7001/storybook
Server storybook https://localhost:7002/storybook

Storybooks

Access a specific story directly using the hash: /storybook#${story-title}

The story title is derived from the filename: handoff-story.svelte → #handoff-tool

Webview Storybook (localhost:7001)

Components for the VS Code extension webview UI.

Thread Components:

  • #thread - Full thread view
  • #streaming-thread - Thread with streaming content
  • #scrollable-thread - Thread with scroll behavior
  • #thread-reply-area - Message input area
  • #thread-status - Thread status indicators
  • #thread-summary - Thread summary view
  • #thread-hints - Thread hint suggestions
  • #thread-environment-input - Environment input

Tool Calls:

  • #bash - Bash tool output
  • #edit-file - File edit diffs
  • #create-file - File creation
  • #read - File read output
  • #grep - Search results
  • #glob - File glob results
  • #handoff-tool - Handoff tool states
  • #mermaid - Diagram rendering
  • #oracle-tool - Oracle tool output
  • #task-tool - Task tool output
  • #web-search - Web search results

Editor & Input:

  • #prompt-editor - Message input editor
  • #mention-menu - @mention autocomplete
  • #combobox - Combobox component
  • #agent-mode-selector - Agent mode picker

Diff Viewer:

  • #diff-viewer - Side-by-side diff
  • #diff-display - Inline diff display
  • #unified-diff - Unified diff format

Settings:

  • #settings-page - Settings page
  • #settings-error-modal - Error modal
  • #sign-in-page - Authentication page

Layout:

  • #layout-navbar - Navigation bar
  • #current-thread-navbar-item - Thread nav item

Server Storybook (localhost:7002)

Components for the ampcode.com web app.

Thread Management:

  • #thread-feed - Thread list feed
  • #thread-feed-item - Individual thread item
  • #thread-feed-list - Virtualized thread list
  • #thread-actions - Thread action buttons
  • #thread-visibility - Visibility settings
  • #thread-visibility-edit - Edit visibility
  • #thread-page - Full thread page
  • #thread-open-in-button - Open in editor button
  • #pull-request-badge - PR badge display

Settings:

  • #settings-access-token-section - API tokens
  • #settings-advanced-section - Advanced settings
  • #settings-client-section - Client settings
  • #billing-section - Billing info
  • #amp-free-section - Free tier info
  • #code-host-connections-section - GitHub/GitLab connections

User & Profile:

  • #avatar - User avatar
  • #profile-card - Profile card
  • #profile-dropdown - Profile menu
  • #user-display - User name display

Dashboard:

  • #welcome - Welcome page
  • #usage-by-day - Usage metrics

UI Components:

  • #amp-logo - Logo variants
  • #badge-single - Single badge
  • #badge-group - Badge group
  • #copyable-text - Copy-to-clipboard text
  • #colors - Color palette
  • #icons - Icon set

OG Images:

  • #og-images - Social preview images

Tips

  • Use take_snapshot to get element UIDs for clicking/filling
  • Story titles use kebab-case from filenames (remove -story.svelte)
  • Reload the skill if MCP tools become unavailable
  • Use list_pages to manage multiple browser tabs