Skip to content

mrzmyr/pixy-mood-tracker-app / .agents/skills/html-prototype

html-prototype

Verified

Build a single-file HTML prototype to explore and decide a UI change before coding it. Use when asked for a prototype, mockup, concept page, design options, or "show me how X could look".

Prototype

Output: one self-contained HTML file in output/pixy-mood-tracker-<slug>/index.html. output/ is gitignored. Never commit prototypes or reference images.

Steps

  1. Frame the question. Write one sentence: what decision the prototype answers. List 2 to 5 options to compare.
  2. Read the rules. DESIGN.md, vision.md, GLOSSARY.md. Find the current screen in src/ and copy its real copy, colors, and spacing.
  3. Research native elements first. For each control (sheet, picker, toolbar, menu, tab bar, switch, date picker, toast):
  4. Research patterns on Mobbin when the pattern is not obvious. Use the Mobbin MCP (search_screens, search_flows). Mobbin has iOS and web only; for Android use Material 3 docs. Pick 3 to 8 references. Link each with its mobbin_url. Never embed or download Mobbin images into the page.
  5. Build the page. See Page structure.
  6. Set up Agentation so Moritz can annotate elements on the page.
  7. Open it and send the file path. Say your pick in one line.

Page structure

Per option, top to bottom:

  • ID and name: stable ID (O1, O2, ...). Never renumber after sharing
  • Mockup: phone frame, real copy, light and dark when color matters
  • Platform toggle when the option uses native elements: iOS and Android side by side, each built from its native pattern. Never show one platform styled as the other
  • Persona switch when the content differs per persona: tabs for the relevant personas from docs/personas.md. Each tab renders that persona's typical data (Lea: mood only, Nina: max load). Always include Nina when layout can overflow
  • Pros and cons: 2 to 4 bullets each, concrete ("1 tap less for Lea", "truncates Jonas's notes")
  • References: Mobbin and guideline links that informed it
  • Decision controls: Accept, Decline, note field

Top of page:

  • The decision question
  • My pick: option ID, why in 2 to 3 sentences, and which persona or platform it serves worst
  • Research summary: native element behavior per platform, Mobbin patterns seen, with links

Decision export

  • Every option has Accept / Decline toggles and an optional note. State persists in localStorage, keyed by slug
  • A sticky Copy decisions button copies plain text to paste back in chat:
Prototype: <slug>
ACCEPT
- O2 Inline chips: <note>
DECLINE
- O1 Bottom sheet: <note>
OPEN
- O3 Full screen
  • After Moritz pastes decisions, implement only the accepted options. Ask about open ones.

Rules

  • Use unique class names (.decision-accept, not .a). Short names collide with mockup styles
  • Fake data only. No real user data, no analytics numbers
  • No bouncy animations. Eased timing only
  • Prefer content on the background over cards
brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation).Stars: 319kUpdated Claude CodeCodexVerifiedInstall
brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply.Stars: 197kUpdated Claude CodeCodexVerifiedInstall
frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults.Stars: 197kUpdated Claude CodeCodexVerifiedInstall
mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).Stars: 197kUpdated Claude CodeCodexVerifiedInstall