Website Design Assistant Skill

Name: Website Design Assistant Skill
Availability: InStock
Author: jarryngandjui

Free Verified 216 lines By jarryngandjui CRO Design

Description

Short Description: A comprehensive AI workflow for end-to-end website design. This SKILL guides you through multi-step collaboration among specialized personas to produce a polished, accessible website. It covers all phases (discovery, layout, style, content, interaction, prototyping) and embeds…

What Claude Learns

→ Purpose & Scope
→ Required Inputs & Pre-Flight Checklist
→ Personas & Roles
→ Multi-Step Workflow
→ Best-Practice Rules & Checklists
→ Design Trend Awareness

Installation

1. Visit the GitHub repository: https://github.com/jarryngandjui/dotfiles
2. Copy the SKILL.md file contents
3. Save to ~/.claude/commands/skill-name.md
4. Restart Claude Code to load the new skill

Stack & Dependencies

JavaScript React HTML CSS

Use Cases

Purpose & Scope

Using JavaScript and React

Required Inputs & Pre-Flight Checklist

Using JavaScript and React

Personas & Roles

Using JavaScript and React

Multi-Step Workflow

Using JavaScript and React

Best-Practice Rules & Checklists

Using JavaScript and React

Related Skills

Frequently Asked Questions

What technologies does Website Design Assistant Skill require?

This skill works with JavaScript, React, HTML, and CSS. Make sure these are available in your project before using the skill with Claude Code.

How detailed is the Website Design Assistant Skill skill?

Website Design Assistant Skill contains 216 lines of structured instructions covering 6 key areas. It provides comprehensive guidance including specific implementation patterns, not just surface-level tips.

Is Website Design Assistant Skill free to use?

Yes u2014 Website Design Assistant Skill is free. Install it directly with one command (`npx mkt-skills install website-design-assistant-skill`) or download the SKILL.md file and drop it into your `~/.claude/skills/` directory. No account, no sign-up, no license fee.

What will Claude Code learn from this skill?

Claude Code will gain expertise in: Purpose & Scope; Required Inputs & Pre-Flight Checklist; Personas & Roles; and 3 more areas.

Download SKILL.md GitHub

# Website Design Assistant Skill

**Short Description:** A comprehensive AI workflow for end-to-end website design. This SKILL guides you through multi-step collaboration among specialized personas to produce a polished, accessible website. It covers all phases (discovery, layout, style, content, interaction, prototyping) and embeds best-practice checks at each step.

## Purpose & Scope  
This Skill supports designing *any* modern website (landing page, e-commerce, blog, etc.) with high UX/UI quality. Outputs can include low/hi-fi wireframes, Figma mockups, HTML/CSS prototypes, component specs, and accessibility reports. It assumes no strict constraints unless specified in inputs. You may customize brand tone, tech stack, or target platform (web, mobile) per project needs.

## Required Inputs & Pre-Flight Checklist  
Before starting, gather all key project info to avoid ambiguity:  
- **Project Goals & Audience:** Who is the website for? What are the business/UX goals?  
- **Brand & Style:** Brand identity (colors, logos, voice). Any style guides?  
- **Content Inventory:** Existing content or assets (text, images) and required pages/sections.  
- **Functional Requirements:** Core pages/flows (e.g. login, checkout), integrations, and features.  
- **Technical Stack:** Preferred frontend frameworks, CMS, performance targets.  
- **Accessibility Targets:** Compliance level (e.g. WCAG 2.1 AA) and devices/platforms (desktop, mobile).  
- **Success Metrics:** How will we measure success? (e.g. conversions, load time).

Confirm or fill in any missing details (assume generic values if unspecified). A solid brief ensures the AI team can proceed confidently.

## Personas & Roles

| Role                    | Key Responsibilities                            | Key Questions                          | Deliverables                        |
|-------------------------|-------------------------------------------------|----------------------------------------|-------------------------------------|
| **UX Researcher**       | Conducts user interviews, personas, surveys.    | *Who are our users? What are their goals? What pain points?* | User personas, empathy maps, research findings |
| **UX Designer**         | Defines site structure, wireframes, flows.      | *What pages and flows solve user needs? How to optimize navigation?* | Site map, wireframe sketches, flow diagrams |
| **UI Designer**         | Creates visual style, components, layouts.      | *What colors, typography, and imagery match the brand?* | Style guide (colors, fonts), hi-fi mockups |
| **Content Strategist**  | Plans information architecture and copy.        | *What messages and microcopy (headings, CTAs) are needed?* | Content outline, written copy for pages |
| **Accessibility Specialist** | Ensures inclusive design (WCAG, ARIA).    | *Are contrast, alt-text, and semantics compliant?* | Accessibility checklist/report |
| **Front-End Developer** | Implements design in code, ensures performance.| *How to translate designs into responsive, optimized code?* | HTML/CSS/JS prototype, component specs |

Each persona “asks” targeted questions (listed above) and produces specific outputs. The AI can adopt these roles sequentially or in a pipeline, ensuring expertise at each stage.

## Multi-Step Workflow

1. **Discovery:**  
   - *Who & What:* **UX Researcher** clarifies target users and goals. Ask: “Who is the user, and what top tasks must the site accomplish?” Gather user needs.  
   - *Output:* Research summary or personas; clear project objectives.

2. **Site Structure:**  
   - *Where & How:* **UX Designer** outlines pages and navigation. Ask: “Design a sitemap and key wireframes (e.g. homepage, user flow).”  
   - *Output:* Site map diagram, low-fidelity wireframes for primary pages.

3. **Visual Design System:**  
   - *Look & Feel:* **UI Designer** defines style. Prompt: “Create a mood board and style guide (colors, fonts, imagery).”  
   - *Output:* Color palette, typography settings, example component designs (buttons, form fields).

4. **Content & Copywriting:**  
   - *Voice & Info:* **Content Strategist** generates on-brand copy. Ask: “Write concise microcopy for CTA buttons, form labels, and headings.”  
   - *Output:* Finalized text (headlines, paragraphs, alt text) integrated into layout placeholders.

5. **Interactions & Motion:**  
   - *Dynamics:* Designers add micro-interactions. Task: “Specify animations/feedback for key interactions (e.g. button hover, dropdown animation).”  
   - *Output:* Interaction guidelines, animation specs or prototype demo (e.g. Figma prototype).

6. **Accessibility & Responsiveness:**  
   - *Inclusive UX:* **Accessibility Specialist** reviews: “Check color contrast ≥4.5:1, keyboard navigation, ARIA labels.” Ensure mobile-responsive behavior.  
   - *Output:* Accessibility audit report, list of fixes (e.g. improve contrast, add alt-text).

7. **Prototyping & Code:**  
   - *Build:* **Front-End Dev** creates a working prototype. Task: “Convert designs into responsive HTML/CSS/JS. Optimize assets for performance.”  
   - *Output:* Prototype or code files, performance metrics.

8. **Review & Iteration:**  
   - *Feedback Loop:* The team reviews and iterates. Use “What’s working? What needs tweaking?” based on stakeholder feedback or test data.  
   - *Output:* Refined prototypes, version notes.

At each numbered step, prompt the AI with the role-specific questions and tasks above, verifying acceptance criteria before moving on.

## Best-Practice Rules & Checklists

- **Progressive Disclosure:** Present functionality in layers (basic tasks first, advanced features later) to avoid overwhelming users【59†L52-L58】. *AC:* Core features visible; advanced options hidden until needed.
- **Color Theory:** Use harmonious palettes (e.g. analogous or complementary schemes) to evoke brand mood【61†L312-L320】. *AC:* Color contrast meets WCAG; palette follows 60-30-10 rule.
- **Visual Hierarchy:** Emphasize important content via size, color, or placement. *AC:* Headline prominence ≥ body text, CTAs distinct.
- **Responsive/Grid Layout:** Ensure layouts adapt to all screen sizes. *AC:* Key elements stack or reflow on mobile with no overlap.
- **Typography:** Choose legible fonts and appropriate scale. *AC:* Font sizes ≥16px for body; line lengths ~50–75 chars.
- **Microcopy Tone:** Keep UI text concise, action-oriented, and friendly. *AC:* CTAs start with a verb (e.g. “Get Started”); error messages clear and helpful.
- **Motion Guidelines:** Use animation to guide (e.g. easing for dropdowns) not distract【59†L91-L100】. *AC:* Animations ≤0.5s, non-blocking transitions.
- **Performance Optimization:** Minimize load time. *AC:* Images/web fonts optimized; critical CSS inline.
- **Accessibility:** Follow WCAG standards. *AC:* Text contrast ≥4.5:1; all interactive elements keyboard-accessible【61†L312-L320】.

Incorporate these checks as a final review checklist or automated linting step to ensure a professional outcome.

## Design Trend Awareness 
> These are trends to be *aware of*, not prescriptions. Evaluate each against your project's specific users and goals before implementing. A clear brand identity always outweighs chasing trends.

The following signals reflect where the web design community is pushing in 2025, largely as a reaction to AI-generated aesthetics, mobile-first constraints, and hyper-UX orthodoxy:

**1. Intentional Imperfections**
Hand-drawn elements, rough layouts, messy textures — deliberately human to counter AI's "too perfect" output. Best for creative agencies, indie brands, and portfolios wanting an authentic feel.
- [madeinhaus.com](https://madeinhaus.com/)
- [ilyaskin.xyz](https://ilyaskin.xyz/)

**2. Micro-Interactions**
Subtle feedback on hover/scroll (slight tilt, border color shift) rather than large choreographed animations. Broadly applicable — small signals that reward attention without overwhelming.
- [hiro.so](https://www.hiro.so/)
- [gentlerain.ai](https://www.gentlerain.ai/)

**3. Bright & Bold**
Oversized headers, high-saturation colors (lime is trending), heavy font weights filling the viewport. Works well for brand-forward landing pages, product launches, and youth-oriented products.
- [joinflowparty.com](https://www.joinflowparty.com/)
- [weareordinaryfolks.com](https://www.weareordinaryfolks.com/)

**4. Text-Heavy Layouts**
Intentional "walls of text" as a pattern interrupt — effective when used deliberately with larger font sizes. Strong fit for editorial sites, manifestos, and brands with a distinctive written voice.
- [folio.showit.site](https://folio.showit.site/)
- [artmilitonian.com](https://artmilitonian.com/)
- [nr.world](https://nr.world/)

**5. Custom Cursors**
Replacing the default pointer with a shape, orb, or branded element. Best used sparingly for portfolios, luxury brands, or experimental/art-direction sites.
- [studioclim.com](https://studioclim.com/)
- [rekorderstudios.com](https://www.rekorderstudios.com/)

**6. Sound Design**
Opt-in ambient audio or interactive sound effects tied to UI events. Suited to immersive experiences, games, and storytelling sites — never autoplay without user consent.
- [motionsickness.co.nz](https://motionsickness.co.nz/)
- [bfcm.stripe.com](https://bfcm.stripe.com/)

**7. Scrollytelling**
Scroll-triggered narrative experiences where content, animations, and layout evolve as the user moves down (or sideways). Great for long-form articles, product explainers, and campaign microsites.
- [mew.xyz](https://mew.xyz/)
- [pinterest.com/pinterest-predicts](https://www.pinterest.com/pinterest-predicts)

**8. Multi-Directional Navigation**
Horizontal scrolling sections, room-based navigation, breaking the purely vertical scroll paradigm. Suited to immersive experiences, portfolios, and product showcases.
- [agorespace.com](https://www.agorespace.com/en-us/)
- [cartier.com/watches](https://www.cartier.com/en-us/watches)

**9. Anti-Usability**
Intentionally unconventional layouts and non-standard navigation — treating users as curious rather than confused. Use with extreme caution; best reserved for experimental/art projects and culture brands.
- [wildeweide.nl](https://wildeweide.nl/en/)
- [newyorksunshine.com](https://newyorksunshine.com/)

### How to Apply Trend Awareness

1. **Start with goals, not trends.** Ask: "If a visitor does only one thing on this site, what should it be?" Only adopt a trend if it serves that outcome.
2. **Use trends as a pattern interrupt.** Trends create contrast — e.g., a text-heavy section stands out precisely *because* most sites avoid it.
3. **Micro-interactions are almost universally safe.** They improve engagement without disrupting usability — always worth considering.
4. **Sound and anti-usability carry the highest risk.** Validate these with user testing before shipping.
5. **Imperfections and bold typography signal authenticity.** Especially effective for brands competing with AI-generated content.

*Source: [Stand Out with the Top 10 Web Design Trends of 2025](https://showit.com/website-tips/stand-out-with-the-top-10-web-design-trends-of-2025/) — Chris Misterek, Showit (Dec 2024)*

## Prompt Templates

- **Startup Layout (full page):** *When:* Building a SaaS or startup site. *Prompt:* “Create a modern website for a tech startup: hero banner, feature sections, testimonials, pricing, and contact form. Use a clean layout with plenty of white space. Provide HTML/CSS and explain each section.” *Output:* Full-page layout with code【36†L117-L120】.
- **Landing Page (product):** *When:* Designing a single product page. *Prompt:* “Design a landing page for a productivity app with hero CTA, feature list, demo video, social proof, and pricing. Use dark mode and modern colors.” *Output:* Focused product page design【36†L140-L144】.
- **Blog/Portfolio Site:** *When:* Creating a personal or content-heavy site. *Prompt:* “Generate a minimal blog homepage: cream background, grid of post summaries, author bio, and nav bar. Use a soft color scheme.” *Output:* Blog layout (possibly in Figma or code)【36†L161-L165】.
- **Marketing Site (Figma):** *When:* Need a polished mockup. *Prompt:* “Create a Figma design for a marketing site with a hero, split feature grid, testimonial slider, and signup form. Use balanced white space and soft colors.” *Output:* Figma file with interactive prototype【36†L181-L185】.
- **Contact Form Code:** *When:* Adding or testing contact functionality. *Prompt:* “Generate a contact page form (Name, Email, Message) with JavaScript validation. Ensure fields are required and email format is checked.” *Output:* Working HTML/CSS/JS form【36†L197-L201】.
- **Navigation Menu:** *When:* Improving site menu. *Prompt:* “Design a user-friendly navigation menu for [SiteName]: logical menu labels, dropdowns as needed, and a mobile hamburger. Ensure high-contrast text and keyboard accessibility.” *Output:* Menu wireframe or HTML/CSS snippet【42†L42-L49】.
- **Footer Design:** *When:* Finishing site template. *Prompt:* “Create a website footer with contact info, social links, and site links. Keep it simple and brand-consistent. Show HTML structure.” *Output:* Footer layout and code【14†L83-L90】.
- **Mobile-Ecommerce Homepage:** *When:* Crafting shop front page. *Prompt:* “Design a mobile-responsive homepage for a fashion retailer: fast-loading images, clear CTAs (‘Shop Now’), and easy checkout access. Use a clean, modern style.” *Output:* Responsive mockup with shopping focus【54†L81-L89】.
- **Accessibility Review:** *When:* Auditing an existing design. *Prompt:* “Review this homepage for accessibility. Check color contrast, alt text, keyboard navigation, and form labels. List any violations and fixes.” *Output:* Accessibility report with issues and recommendations.
- **Persona Checklist:** *When:* Validating user alignment. *Prompt:* “Summarize key user personas for this site and list their main goals and preferred content.” *Output:* Persona profiles (beneficial for aligning design).

*(Add additional prompts tailored to your context as needed.)*

## Output Examples  
Request one or more of the following output formats to suit your needs:  
- **Wireframes:** Sketches or annotated images (PNG/PDF) of page layouts.  
- **Figma File:** Shared Figma link or exported frames (with style guide embedded).  
- **Code Prototype:** HTML/CSS/JS snippet or repository link for interactive demo.  
- **Component Spec:** Document (MD or HTML) detailing UI components, CSS variables.  
- **Accessibility Report:** Checklist or HTML report with pass/fail items.

Indicate the desired output in your prompt (e.g. “Provide a Figma prototype…”).

## Prompt Validation Metrics

To choose and refine prompts, track community endorsement metrics:  
```
Likes      : ********** (10)
Stars      : ********** (10)
Installs   : ********   (8)
Comments   : ******     (6)
Forks      : *****      (5)
Shares     : ****       (4)
```  
*Bar chart: Recommended metrics to rate prompts*

For example, Taskade’s website prompts have **1M+ users**【14†L83-L90】. Figma’s “figgpt” plugin shows **100k installs**【65†L45-L48】. DocsBot lists **75k+ uses**【46†L94-L99】. Prefer prompts/tools with higher counts. Rank prompts by likes/upvotes or stars on GitHub/Twitter. Validate by how often a prompt is shared or forked.

## Troubleshooting & FAQ

- **Q:** *Prompt isn’t producing the expected style.*  
  **A:** Clarify style adjectives or provide examples. E.g. specify “minimalist, monochrome palette” or attach an example image.  
- **Q:** *AI misunderstood a requirement.*  
  **A:** Refine the prompt to remove ambiguity. Break complex tasks into smaller steps with separate prompts.  
- **Q:** *Resulting design is not responsive or accessible.*  
  **A:** Ensure you included those constraints in inputs/checklist. Re-run accessibility check (WCAG). Example: “Refine CSS for mobile layout.”  
- **Q:** *How to handle iterative feedback?*  
  **A:** Provide the AI with version history or incremental feedback. Use a prompt like “Given this current design, adjust X.”

Iterate by treating each persona’s output as a checkpoint, revisiting any earlier step if needed.

## Changelog & Attribution

- **Sources:** Based on high-engagement prompt libraries and guides. Prioritize *Taskade* and *Figma Community* (plugins, files), *GitHub repos*, *Medium/Notion articles*, and active *social threads*. Use official or community-verified examples when citing prompt language.  
- *Mar 2026:* Initial Skill creation with multi-persona workflow (inspired by Claude SKILL formats) and prompt templates from Taskade and design blogs.
- *Mar 2026:* Added Design Trend Awareness section covering 9 key 2025 web design trends (imperfections, micro-interactions, bold typography, scrollytelling, etc.) with guidance on when to apply them.  
- *Sources include:* AI prompt repositories (Taskade AI Prompts, DocsBot) and UX design blogs, as well as Figma plugin usage stats【14†L83-L90】【65†L45-L48】.

```mermaid
flowchart TD
    A[Gather inputs & goals] --> B[UX Researcher: define users and requirements]
    B --> C[UX Designer: create sitemap & wireframes]
    C --> D[UI Designer: develop visual style guide]
    D --> E[Content Strategist: draft copy and microcopy]
    E --> F[Team: add interactions & animations]
    F --> G[Accessibility Specialist: verify compliance]
    G --> H[Front-end Dev: code prototype & optimize]
    H --> I{Review & Iterate}
    I --> C
```
*Flowchart: Multi-persona website design process.*

Description

What Claude Learns

Installation

Stack & Dependencies

Use Cases

Purpose & Scope

Required Inputs & Pre-Flight Checklist

Personas & Roles

Multi-Step Workflow

Best-Practice Rules & Checklists

Related Skills

Ui Ux Pro

Hackathon Landing Pwa

Frontend Dev

Auto Website Builder

Frequently Asked Questions

AI Marketing Skills Newsletter