Skip to content
cccskills
FreePublished on GitHub

prototype

Build a self-contained UI prototype for design exploration. Creates an unauthed page in the real web app with stress-test mock data, exposes the dev server for preview, and runs visual audits at mobile and desktop viewports. Use when exploring layouts, information architecture, or interaction patterns before production implementation.

The English summary is being prepared. Showing the original description.

raphaeltm/simple-agent-manager68 stars(GitHub 68 + cccskills 0)
Works withPlaywright

Run score Not tested

See how to install

Files included (1)

  • SKILL.md2.5 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

UI Prototype Builder

Build a self-contained UI prototype inside the real web app for design exploration and UX iteration.

Full Rules

Read .claude/rules/37-prototype-development.md for the complete prototype development rules. Everything below is a summary workflow.

Workflow

1. Audit the Existing UI

Before building, read the current implementation to understand:

  • What components and patterns already exist
  • What design tokens and styles are in use
  • What the current UX problems are

2. Create the Prototype

Create two files:

apps/web/src/pages/<name>-prototype/
  ├── index.tsx       # Main component — self-contained, no API calls, no auth
  └── mock-data.ts    # Stress-test mock data (long text, many items, empty states, edge cases)

Critical requirements:

  • Wrap content in a scrollable container: <div style={{ height: '100vh', overflow: 'auto' }}>
  • Use existing components (VmSizeCard, @simple-agent-manager/ui, etc.) wherever possible
  • Match the app's design tokens and dark theme
  • Design mobile-first (375px), then enhance for desktop (1280px)
  • Include mock data that pushes UI boundaries — this is how we find where it breaks

3. Wire the Route

Add to App.tsx in the public routes section:

import { MyPrototype } from './pages/<name>-prototype';

// In Routes, alongside other public routes:
<Route path="/prototype/<name>" element={<MyPrototype />} />

4. Start the Dev Server and Expose

cd apps/web && npx vite --host 0.0.0.0

Then expose the port using the SAM MCP expose_port tool (port 5173, protocol http). Share the resulting URL with the user.

5. Visual Audit

Run Playwright screenshots at both viewports:

  • Mobile: 375x667
  • Desktop: 1280x800

Check for: overflow, clipping, text wrapping, interactive element usability, empty states, long content handling.

Save screenshots to .codex/tmp/playwright-screenshots/.

NEVER Deploy to Production

Prototypes may be committed to feature branches for collaboration. They MUST be removed before any merge to main:

  • Delete prototype page directory
  • Remove route from App.tsx
  • Remove import from App.tsx

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

Full API endpoint reference for SAM. Use when working on API routes, adding endpoints, writing API tests, or understanding the API surface. Trigger when asked about API endpoints, routes, or HTTP interfaces.

The English summary is being prepared. Showing the original description.

raphaeltm/simple-agent-manager68Updated Oct 26, 2026

Full API endpoint reference for SAM. Use when working on API routes, adding endpoints, writing API tests, or understanding the API surface.

The English summary is being prepared. Showing the original description.

raphaeltm/simple-agent-manager68Updated Oct 26, 2026

Recent feature changes and implementation details for SAM. Use when understanding recent changes, checking what was modified recently, or understanding feature history. Trigger when asked about recent changes, what's new, or feature history.

The English summary is being prepared. Showing the original description.

raphaeltm/simple-agent-manager68Updated Oct 26, 2026

Recent feature changes and implementation details for SAM. Use when understanding recent changes, checking what was modified recently, or understanding feature history.

The English summary is being prepared. Showing the original description.

raphaeltm/simple-agent-manager68Updated Oct 26, 2026

Cloudflare Workers architecture specialist. Advises on D1 migrations, KV usage patterns, R2 binary distribution, wrangler configuration, and Miniflare testing. Use when modifying wrangler.toml, working with Cloudflare services, or setting up testing infrastructure.

The English summary is being prepared. Showing the original description.

raphaeltm/simple-agent-manager68Updated Oct 26, 2026

Constitution compliance validator focusing on Principle XI (No Hardcoded Values). Detects hardcoded URLs, timeouts, limits, and identifiers that should be configurable. Use proactively when implementing business logic, adding new features, or reviewing PRs for constitution compliance.

The English summary is being prepared. Showing the original description.

raphaeltm/simple-agent-manager68Updated Oct 26, 2026

See all skills by raphaeltm

Report a problem with this skill