Imported from starchild-ai-agent/official-skills (ui-templates/SKILL.md). Install upstream with npx skills add starchild-ai-agent/official-skills --skill ui-templates. Copyright stays with the author.

UI Templates — Human-Designed Template Library

380 pre-built HTML/CSS/JS templates from 9 professional template libraries. All templates are human-designed with real design quality — NOT AI-generated. The agent MUST use an existing template as the starting point. Never write HTML/CSS/JS from scratch.

1. How to Find Templates

Step 1 — Determine the Category

Match the user's request to one or more categories from §4 Category Reference. Be precise — match the user's actual stated need, not a generalized assumption.

• "I want a restaurant website" → restaurant
• "Build me a portfolio" → portfolio
• "I need a blog" → blog
• "Make a landing page for my app" → app or landing
• Unclear or general request → read 2-3 candidate category catalogs and compare

Step 2 — Read the Category Catalog

Each category has a JSON catalog file: catalogs/{category}.json (relative to this skill directory).

read_file("skills/ui-templates/catalogs/{category}.json")

If no specific category matches, use catalogs/multipurpose.json. For broad requests, read multiple catalogs (e.g., both personal and portfolio).

Step 3 — Match Templates Using Catalog Metadata

Each catalog entry contains rich metadata for intelligent selection:

Matching priority:

1. matchSignals keyword overlap with user request
2. features and sections matching user's functional needs
3. colorScheme + visualStyle matching user's aesthetic preference
4. source quality tier (prefer higher tiers)

Step 4 — Download and Use the Template

Templates are hosted on GCS. Each catalog entry has a downloadUrl field pointing to a .zip file.

# Download and extract the template
curl -sL "{downloadUrl}" -o /tmp/template.zip
mkdir -p output/website
unzip -o /tmp/template.zip -d output/website/
rm /tmp/template.zip

After extraction, use the indexPath field from the catalog entry to locate the index.html within the extracted directory.

2. Customization Guide

When customizing a template, focus on content replacement while preserving the human-designed structure:

1. Page title & headings — Update <title> and main headings
2. Navigation — Adjust nav links to match actual sections
3. Body text — Replace lorem ipsum with real content
4. Images — Keep template originals unless user provides their own
5. Colors — Use colorPalette to understand which CSS properties to modify for brand colors
6. Fonts — Keep the template's fonts (already well-chosen by human designers)
7. Sections — Add/remove/reorder sections to match user needs
8. Responsive — Most templates are already responsive. Check breakpoints field.

3. Template Sources & Quality Tiers

Source quality preference: web3 > html5up > styleshout > startbootstrap > tooplate > themefisher > templatemo

Tier 1 — Premium (prefer these)

• Web3 (14 templates): Crypto/DeFi/NFT dashboards and tools. Dark themes, real-time data, Chart.js. Best for blockchain projects.
• HTML5 UP (29 templates): Clean, modern, responsive. Best overall design quality. Pure HTML/CSS/JS.
• StyleShout (36 templates): Professional, polished. Great for portfolios and personal sites.
• Start Bootstrap (12 templates): Bootstrap-based, well-structured. Good for business sites.

Tier 2 — Good

• Tooplate (88 templates): Large variety, decent quality. Good for specific niches.
• ThemeFisher (42 templates): Bootstrap-based, professional.
• AdminMart (1 template): Dashboard template.
• GitHub (2 templates): Community-contributed templates.

Tier 3 — Supplementary

• TemplateMo (156 templates): Largest collection, variable quality. Good for niche categories.

4. Category Reference (36 categories)

5. Catalog Entry Format

Full example of an enriched catalog entry:

{
  "id": "html5up-editorial",
  "source": "html5up",
  "dir": "html5up/editorial",
  "name": "Editorial",
  "title": "Editorial by HTML5 UP",
  "category": "blog",
  "hasIndex": true,
  "hasCss": true,
  "hasJs": true,
  "hasImages": true,
  "sizeKB": 3531,
  "indexPath": "html5up/editorial/index.html",
  "description": "Sidebar-layout blog/magazine template with a persistent left sidebar...",
  "colorScheme": "light",
  "primaryColor": "#f56a6a",
  "colorPalette": {
    "background": "#ffffff",
    "sidebarBg": "#f5f6f7",
    "text": "#7f888f",
    "heading": "#3d4449",
    "accent": "#f56a6a (coral-red)",
    "accentHover": "#f67878",
    "accentActive": "#f45c5c",
    "border": "#eff1f2",
    "muted": "#9fa3a6"
  },
  "typography": {
    "fontFamily": "Open Sans (body) + Roboto Slab (headings)",
    "headingWeight": "700",
    "bodyWeight": "400",
    "bodySize": "13pt",
    "letterSpacing": "wide (0.075em)",
    "style": "Serif+sans-serif dual font pairing. Editorial sophistication."
  },
  "layout": "sidebar",
  "layoutDetails": "Two-column: fixed left sidebar + scrollable main. Sidebar collapses to hamburger on mobile.",
  "visualStyle": "Editorial, magazine-like. Coral-red accent. Serif+sans-serif font pairing.",
  "features": ["responsive", "search", "hamburger-menu", "social-links", "accordion"],
  "sections": ["header", "navigation", "hero", "features", "blog", "contact", "footer"],
  "techStack": ["jquery", "font-awesome", "google-fonts"],
  "breakpoints": [360, 480, 736, 980, 1280, 1680],
  "matchSignals": ["blog", "magazine", "editorial", "sidebar", "search", "articles", "coral", "serif"]
}

6. Important Notes

• All 380 templates are usable — every template has an index.html file. Use indexPath to find it under ui-templates/.
• Category catalogs — read catalogs/{category}.json for enriched metadata.
• Keep the human design — these templates look good because humans designed them. Don't over-modify the CSS structure.
• Use colorPalette for customization — when the user has brand colors, use colorPalette to understand which CSS colors to replace.
• Responsive — most templates are already responsive. Check breakpoints for responsive behavior.