Skip to content

notque/vexjoy-agent / skills/frontend/frontend

frontend

Unverified

Frontend: UI design, distinctive visual styles, HTML artifacts, Three.js 3D, TypeScript/React/Next.js apps, e-commerce, portfolios, React Native, web performance.

FileKindSize
SKILL.mdskill md22.5 KB
SPEC.mdmarkdown4.3 KB
agents/html-builder.mdmarkdown5.9 KB
assets/base-template.htmlother495 B
references/design-refs/accessibility-review.mdmarkdown13.0 KB
references/design-refs/design-critique.mdmarkdown10.4 KB
references/design-refs/design-handoff.mdmarkdown9.9 KB
references/design-refs/design-systems.mdmarkdown9.3 KB
references/design-refs/llm-design-failure-modes.mdmarkdown9.1 KB
references/design-refs/ux-copy.mdmarkdown9.5 KB
references/distinctive-frontend-design-refs/animation-patterns.mdmarkdown10.5 KB
references/distinctive-frontend-design-refs/background-techniques.mdmarkdown10.5 KB
references/distinctive-frontend-design-refs/balatro-shader-breakdown.mdmarkdown14.9 KB
references/distinctive-frontend-design-refs/card-shader-patterns.mdmarkdown10.9 KB
references/distinctive-frontend-design-refs/color-inspirations.jsonconfig9.4 KB
references/distinctive-frontend-design-refs/css-audit-patterns.mdmarkdown4.7 KB
references/distinctive-frontend-design-refs/font-catalog.jsonconfig9.7 KB
references/distinctive-frontend-design-refs/game-ui-polish.mdmarkdown6.3 KB
references/distinctive-frontend-design-refs/honest-placeholders.mdmarkdown3.2 KB
references/distinctive-frontend-design-refs/implementation-examples.mdmarkdown7.7 KB
references/distinctive-frontend-design-refs/macrostructure-catalog.mdmarkdown9.3 KB
references/distinctive-frontend-design-refs/oklch-color-harmony.mdmarkdown7.3 KB
references/distinctive-frontend-design-refs/performance-budgets.mdmarkdown10.6 KB
references/distinctive-frontend-design-refs/phase-details.mdmarkdown4.8 KB
references/distinctive-frontend-design-refs/pptx-conversion.mdmarkdown9.7 KB
references/distinctive-frontend-design-refs/roll-text.mdmarkdown7.2 KB
references/distinctive-frontend-design-refs/shader-integration-react.mdmarkdown16.7 KB
references/distinctive-frontend-design-refs/slide-controller.mdmarkdown9.4 KB
references/distinctive-frontend-design-refs/text-animation-patterns.mdmarkdown4.3 KB
references/html-artifact-refs/design-system.mdmarkdown10.2 KB
references/html-artifact-refs/diagram-layering.mdmarkdown3.9 KB
references/html-artifact-refs/infographic-layouts.mdmarkdown4.9 KB
references/html-artifact-refs/pdf-export.mdmarkdown6.0 KB
references/html-artifact-refs/pptx-export.mdmarkdown10.2 KB
references/html-artifact-refs/shape-diagram-illustration.mdmarkdown4.3 KB
references/nextjs-ecommerce.mdmarkdown3.4 KB
references/nextjs-ecommerce/admin-dashboard.mdmarkdown9.8 KB
references/nextjs-ecommerce/error-catalog.mdmarkdown7.9 KB
references/nextjs-ecommerce/expertise.mdmarkdown5.1 KB
references/nextjs-ecommerce/patterns-and-errors.mdmarkdown4.6 KB
references/nextjs-ecommerce/preferred-patterns.mdmarkdown8.0 KB
references/nextjs-ecommerce/shopping-cart-patterns.mdmarkdown7.7 KB
references/nextjs-ecommerce/stripe-integration.mdmarkdown9.5 KB
references/performance-optimization.mdmarkdown9.9 KB
references/performance-optimization/browser-dom-optimizations.mdmarkdown6.0 KB
references/performance-optimization/bundle-optimization.mdmarkdown7.9 KB
references/performance-optimization/core-web-vitals.mdmarkdown9.6 KB
references/performance-optimization/js-algorithm-optimizations.mdmarkdown9.6 KB
references/performance-optimization/metrics-and-monitoring.mdmarkdown8.8 KB
references/performance-optimization/nextjs-optimization.mdmarkdown10.6 KB
references/performance-optimization/performance-testing.mdmarkdown9.6 KB
references/performance-optimization/preferred-patterns.mdmarkdown7.4 KB
references/performance-optimization/react-async-patterns.mdmarkdown7.0 KB
references/performance-optimization/react-bundle-optimization.mdmarkdown6.3 KB
references/performance-optimization/react-rendering-performance.mdmarkdown12.0 KB
references/react-native.mdmarkdown4.4 KB
references/react-native/animation-patterns.mdmarkdown3.9 KB
references/react-native/error-handling.mdmarkdown7.7 KB
references/react-native/list-performance.mdmarkdown5.4 KB
references/react-native/monorepo-config.mdmarkdown2.3 KB
references/react-native/navigation-patterns.mdmarkdown2.0 KB
references/react-native/rendering-patterns.mdmarkdown3.2 KB
references/react-native/state-management.mdmarkdown3.3 KB
references/react-native/testing.mdmarkdown6.2 KB
references/react-native/ui-patterns.mdmarkdown5.0 KB
references/react-portfolio.mdmarkdown7.7 KB
references/react-portfolio/gallery-patterns.mdmarkdown2.5 KB
references/react-portfolio/image-optimization.mdmarkdown3.4 KB
references/react-portfolio/lightbox-patterns.mdmarkdown6.1 KB
references/react-portfolio/nextjs-app-router.mdmarkdown4.9 KB
references/react-portfolio/performance.mdmarkdown3.9 KB
references/react-portfolio/portfolio-seo.mdmarkdown4.8 KB
references/react-portfolio/responsive-design.mdmarkdown3.3 KB
references/threejs-builder-refs/advanced-animation.mdmarkdown12.1 KB
references/threejs-builder-refs/advanced-topics.mdmarkdown11.0 KB
references/threejs-builder-refs/build-recipes.mdmarkdown7.4 KB
references/threejs-builder-refs/game-architecture.mdmarkdown10.4 KB
references/threejs-builder-refs/game-patterns.mdmarkdown12.5 KB
references/threejs-builder-refs/gltf-loading.mdmarkdown8.6 KB
references/threejs-builder-refs/performance-patterns.mdmarkdown11.8 KB
references/threejs-builder-refs/react-three-fiber.mdmarkdown17.8 KB
references/threejs-builder-refs/shader-patterns.mdmarkdown15.0 KB
references/threejs-builder-refs/visual-polish.mdmarkdown16.3 KB
references/threejs-builder-refs/webgpu.mdmarkdown20.4 KB
references/typescript-frontend.mdmarkdown5.3 KB
references/typescript-frontend/engineering-rules.mdmarkdown7.8 KB
references/typescript-frontend/nextjs-security.mdmarkdown2.6 KB
references/typescript-frontend/react-view-transitions.mdmarkdown5.4 KB
references/ui-design.mdmarkdown10.2 KB
references/ui-design/ai-slop-detection.mdmarkdown8.5 KB
references/ui-design/design-conventions.mdmarkdown2.8 KB
references/ui-design/motion-and-interaction.mdmarkdown5.6 KB
scripts-distinctive-frontend-design/css_slop_rules.pyscript15.3 KB
scripts-distinctive-frontend-design/tests/test_css_slop_rules.pyscript6.9 KB
scripts-distinctive-frontend-design/tests/test_validate_design_advisory.pyscript3.3 KB
scripts-distinctive-frontend-design/tests/test_validate_design_macro.pyscript4.3 KB
scripts-distinctive-frontend-design/validate_design.pyscript22.2 KB
scripts-html-artifact/assemble-template.pyscript7.5 KB
scripts-html-artifact/css_slop_rules.pyscript15.4 KB
scripts-html-artifact/detect-shape.pyscript7.0 KB
scripts-html-artifact/fill-template.pyscript5.5 KB
scripts-html-artifact/pptx-bridge/__init__.pyscript490 B
scripts-html-artifact/pptx-bridge/_pptx_engine.pyscript26.4 KB
scripts-html-artifact/pptx-bridge/extract_slides.pyscript13.5 KB
scripts-html-artifact/pptx-bridge/render_pptx.pyscript6.9 KB
scripts-html-artifact/pptx-bridge/run-unified.pyscript11.6 KB
scripts-html-artifact/render-github-issues.pyscript7.5 KB
scripts-html-artifact/tests/test_assemble_template.pyscript29.5 KB
scripts-html-artifact/tests/test_css_slop_emission.pyscript7.9 KB
scripts-html-artifact/tests/test_detect_shape.pyscript5.3 KB
scripts-html-artifact/tests/test_fill_template.pyscript5.2 KB
scripts-html-artifact/tests/test_to_pdf.pyscript13.3 KB
scripts-html-artifact/tests/test_validate_artifact.pyscript13.6 KB
scripts-html-artifact/to-pdf.pyscript12.5 KB
scripts-html-artifact/validate-artifact.pyscript11.0 KB
templates/base-reset.cssother1.2 KB
templates/components/collapsible.cssother1.1 KB
templates/components/collapsible.jsscript516 B
templates/components/copy-button.cssother534 B
templates/components/copy-button.jsscript334 B
templates/components/drag-drop.cssother612 B
templates/components/drag-drop.jsscript1.1 KB
templates/components/filter.cssother1.1 KB
templates/components/filter.jsscript987 B
templates/components/keyboard-nav.cssother249 B
templates/components/keyboard-nav.jsscript900 B
templates/components/scrollytelling.cssother1.5 KB
templates/components/scrollytelling.jsscript2.0 KB
templates/components/slider.cssother848 B
templates/components/tabs.cssother770 B
templates/components/tabs.jsscript508 B
templates/components/theme-toggle.cssother1.2 KB
templates/components/theme-toggle.jsscript178 B
templates/fonts/ArchivoBlack-OFL.txtmarkdown4.4 KB
templates/fonts/archivo-black.cssother13.7 KB
templates/print/code-review-print.cssother1.9 KB
templates/print/data-viz-print.cssother1.5 KB
templates/print/deck-print.cssother1.5 KB
templates/print/default-print.cssother1.6 KB
templates/print/diagram-print.cssother1.6 KB
templates/print/editor-print.cssother2.1 KB
templates/print/prototype-print.cssother1.4 KB
templates/print/report-print.cssother1.8 KB
templates/print/spec-print.cssother1.4 KB
templates/saved/README.mdmarkdown1.8 KB
templates/saved/business-review.htmlother17.1 KB
templates/saved/business-review.slots.jsonconfig1.5 KB
templates/saved/github-issues.htmlother34.0 KB
templates/saved/project-kickoff.htmlother17.3 KB
templates/saved/project-kickoff.slots.jsonconfig1.7 KB
templates/saved/system-design.htmlother16.9 KB
templates/saved/system-design.slots.jsonconfig1.6 KB
templates/shapes/code-review.cssother2.7 KB
templates/shapes/data-viz.cssother2.3 KB
templates/shapes/deck.cssother1.9 KB
templates/shapes/diagram.cssother2.7 KB
templates/shapes/editor.cssother2.8 KB
templates/shapes/prototype.cssother2.7 KB
templates/shapes/report.cssother2.9 KB
templates/shapes/spec.cssother3.0 KB
templates/themes/birchline.cssother2.4 KB
templates/themes/dark-focus.cssother2.6 KB
templates/themes/interactive-warm.cssother4.5 KB
templates/themes/minimal-document.cssother2.6 KB

references/design-refs/design-critique.md

View on GitHub
# Design Critique Reference

Structured methodology for evaluating designs. Concrete frameworks that change model behavior — not "give constructive feedback" generics.

---

## Four-Step Critique Method

Apply in order. Each step builds on the previous.

### Step 1: Describe (What Is Present)

Observe and name without judgment. This forces careful looking before evaluating.

| Observe | Questions |
|---------|-----------|
| Elements | What components, images, text blocks, and controls are present? |
| Layout | How is content organized? Grid, hierarchy, grouping? |
| Visual relationships | What's near what? What aligns? What stands alone? |
| Color usage | What palette? How many colors? Where are they used? |
| Typography | How many type sizes? Weights? What creates the reading order? |
| Spacing | Tight or loose? Consistent or varied? Where does white space live? |

**Output**: Neutral inventory. "The page has a two-column layout with a sidebar navigation on the left and a content area on the right. Three heading levels are visible."

### Step 2: Analyze (How Principles Apply)

Evaluate the design against fundamental principles:

| Principle | What to Check | Strong Signal | Weak Signal |
|-----------|--------------|---------------|-------------|
| **Contrast** | Do important elements stand out? | CTA visually distinct from surrounding elements | Primary and secondary actions look the same |
| **Hierarchy** | Is there a clear reading order? | Eye follows: heading -> key content -> CTA | Multiple elements compete for attention |
| **Alignment** | Are elements on a consistent grid? | Clean vertical and horizontal alignment | Elements placed "close enough" without snapping |
| **Proximity** | Are related items grouped? | Labels near their fields, actions near their context | Related elements scattered across the screen |
| **Repetition** | Are patterns consistent? | Same card style used for all similar content | Each card has slightly different padding/layout |
| **Balance** | Does the layout feel stable? | Visual weight distributed intentionally | One side heavy with content, other empty |

### Step 3: Interpret (What the Design Communicates)

| Dimension | Questions |
|-----------|-----------|
| Emotional tone | Does it feel professional, playful, urgent, calm? Is that appropriate? |
| Brand alignment | Does it look like it belongs to this product/brand? |
| User expectations | Would users recognize this as [type of screen]? Does it match their mental model? |
| Information priority | What does the design say is most important? Is the design right? |
| Trust signals | Does it feel trustworthy? Reliable? Appropriate for the data sensitivity? |

### Step 4: Evaluate (What Works, What to Improve)

Structure every finding as: **Element + Issue + Impact + Recommendation**.

| Element | Weak Feedback | Strong Feedback |
|---------|--------------|----------------|
| CTA button | "The button doesn't stand out" | "The primary CTA ('Start trial') uses the same visual weight as navigation links. Users may miss it. Increase contrast: use a filled button with `color-brand-primary` background." |
| Form layout | "The form is confusing" | "Card number, expiry, and CVV appear in a single column at full width. Group them in a row to match the physical card layout and reduce vertical scrolling." |
| Error state | "Error handling is bad" | "Form validation shows all errors at the top of the form. Users must scroll up to see them, then scroll back down to fix them. Show each error inline below its field." |

---

## Nielsen's 10 Heuristics — Applied

Each heuristic with concrete application to real design patterns. Apply to the specific design; skip heuristics that do not apply.

### 1. Visibility of System Status

The system keeps users informed about what is happening.

| Pattern | Strong | Weak |
|---------|--------|------|
| File upload | Progress bar with percentage and estimated time | Spinner with no indication of progress or duration |
| Form submission | Button shows loading state, then success confirmation | Page refreshes with no feedback |
| Background process | Status indicator: "Syncing 3 of 12 files..." | Nothing visible until complete |
| Search | Results count and load time shown | Results appear with no context |

### 2. Match Between System and Real World

Use language and concepts familiar to users.

| Pattern | Strong | Weak |
|---------|--------|------|
| Terminology | "Shopping cart" (matches mental model) | "Procurement queue" (internal jargon) |
| Organization | Calendar view for scheduling | Timestamp list for scheduling |
| Icons | Trash can for delete | Abstract geometric shape for delete |

### 3. User Control and Freedom

Users make mistakes. Provide exits, undo, and recovery.

| Pattern | Strong | Weak |
|---------|--------|------|
| Destructive action | "Undo" toast for 10 seconds after deletion | Immediate permanent deletion |
| Navigation | Clear back button, breadcrumbs | Deep modal with no escape route |
| Multi-step flow | "Save draft" available at every step | Losing all progress on back navigation |

### 4. Consistency and Standards

Follow platform conventions and internal patterns.

| Check | Questions |
|-------|-----------|
| Platform | Does it follow iOS/Android/Web conventions for this control type? |
| Internal | Does it match other screens in the same product? |
| Industry | Does it match user expectations from similar products? |
| Visual | Same spacing, colors, typography for same element types? |

### 5. Error Prevention

Design to prevent errors before they happen.

| Pattern | Strong | Weak |
|---------|--------|------|
| Input formatting | Auto-format phone number as user types | Reject input after submission for wrong format |
| Destructive action | Require typing project name to confirm deletion | Single "Delete" button with no confirmation |
| Data loss | Auto-save with version history | No save reminder before navigating away |

### 6. Recognition Over Recall

Make options visible. Reduce memory load.

| Pattern | Strong | Weak |
|---------|--------|------|
| Navigation | Visible sidebar with all sections | Remembering keyboard shortcuts for navigation |
| Search | Recent searches and suggestions shown | Empty search box with no hints |
| Forms | Dropdown with options visible | Free-text field requiring exact format |

### 7. Flexibility and Efficiency of Use

Serve both novices and experts.

| Pattern | Strong | Weak |
|---------|--------|------|
| Power users | Keyboard shortcuts + visual UI both available | Keyboard only or mouse only |
| Customization | Configurable dashboard with sensible defaults | Fixed layout for all users |
| Shortcuts | Recent/favorite items accessible | Start from scratch every time |

### 8. Aesthetic and Minimalist Design

Every element earns its space. Visual noise competes with content.

| Check | Questions |
|-------|-----------|
| Content priority | Is the most important content most prominent? |
| Visual noise | Are there decorative elements that add no information? |
| Density | Is there enough white space for comfortable scanning? |
| Distraction | Do secondary elements pull attention from primary tasks? |

### 9. Help Users Recognize, Diagnose, and Recover from Errors

Error messages are plain language, indicate the problem, and suggest a solution.

| Pattern | Strong | Weak |
|---------|--------|------|
| Form error | "Password must be at least 8 characters" shown at the field | "Error" shown at top of page |
| System error | "We couldn't save your changes. Your work is safe — try again in a moment." | "500 Internal Server Error" |
| Auth error | "Wrong password. Reset your password?" with link | "Authentication failed" |

### 10. Help and Documentation

Provide contextual help where users need it.

| Pattern | Strong | Weak |
|---------|--------|------|
| Complex feature | Inline tooltip explaining the option | Separate help page requiring navigation away |
| First use | Contextual walkthrough of key features | 20-step feature tour on first login |
| Edge case | "Learn more" link next to advanced option | No explanation of advanced options |

---

## Cognitive Walkthrough Methodology

Simulate a new user attempting a specific task. For each step:

| Question | What It Reveals |
|----------|----------------|
| Will the user try to achieve the right effect? | Is the goal clear? |
| Will the user see the correct action is available? | Is the affordance visible? |
| Will the user associate the action with the desired effect? | Is the label/icon clear? |
| Will the user see progress after taking the action? | Is feedback provided? |

**Walkthrough output**: Step-by-step table with each action, success/failure prediction, and specific issues found.

---

## Critique Framing by Audience

| Audience | Frame | Focus | Language |
|----------|-------|-------|----------|
| Designer (peer) | Collaborative exploration | Design decisions, alternatives, rationale | "Have you considered..." / "What if..." |
| Designer (junior) | Educational, encouraging | Principles applied, growth areas, what works | "This works because..." / "Try this approach..." |
| Stakeholder | Impact-focused | User impact, business goals, competitive context | "Users will..." / "This supports [goal] by..." |
| Developer | Actionable, specific | Implementation implications, edge cases, specs | "This needs [specific state]" / "Token: [name]" |
| Cross-functional review | Balanced, structured | Findings organized by severity and category | Numbered findings, severity levels, priority order |

---

## Critique Failure Modes

| Failure Mode | Do instead |
|-------------|-----------|
| Vague praise: "Looks good" | Specific observation: "The card grid creates a consistent scanning pattern and the hover states clearly indicate interactivity" |
| Vague criticism: "This is confusing" | Specific finding: "The filter controls and sort controls use the same visual style, making it unclear which is which. Differentiate with distinct grouping or labels." |
| Unsolicited redesign: "You should redo the whole layout" | Targeted recommendation: "The sidebar navigation competes with the main content. Consider reducing sidebar width or collapsing it by default." |
| Subjective preference: "I don't like the color" | Principled feedback: "The blue links on the blue-tinted background have a contrast ratio of 2.8:1, below the 4.5:1 WCAG AA requirement." |
| Missing context: Critiquing a prototype for pixel-perfection | Stage-appropriate feedback: "Since this is an early prototype, focusing on the flow: the 3-step checkout reduces friction compared to the current 5-step flow." |
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: 322kUpdated 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: 198kUpdated 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: 198kUpdated 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: 198kUpdated Claude CodeCodexVerifiedInstall