Style Guide Generator
Overview
Generate professionally formatted website style guides and design systems by analyzing provided URLs, screenshots, uploaded files, and user requirements. Output comprehensive PDF documents that serve as the single source of truth for design and development teams.
Workflow Decision Tree
When a user requests a style guide, follow this decision tree:
Gather Information
- If user provides URL → Use web_fetch to analyze the website
- If user provides screenshots/images → Analyze visual elements
- If user provides existing documentation → Extract and structure information
- If user provides minimal information → Ask clarifying questions about brand, goals, and requirements
Extract Design Elements
- Colors (primary, secondary, accent, text, background, success, warning, error)
- Typography (fonts, weights, sizes, line heights)
- Logo usage guidelines
- Iconography style
- Imagery preferences
- UI component patterns
- Layout and spacing systems
- Accessibility requirements
Structure Content
- Follow the standard template structure (see Template Structure section)
- Organize extracted information into appropriate sections
- Add mission/vision if provided or inferred
- Document design principles
- Create component specifications
Generate PDF
- Use the PDF skill to create a professional document
- Apply consistent formatting and typography
- Include tables for color palettes, typography specs, and component states
- Ensure accessibility with proper contrast ratios
- Add version number and last updated date
Standard Template Structure
Every style guide should follow this professional structure (based on industry best practices):
1.0 Introduction
- Version number and last updated date
- Purpose and scope statement
- Target audience (design and development teams)
1.1 Mission & Vision
- Company mission statement
- Company vision statement
- Strategic positioning
1.2 Design Principles
- 4-6 core principles that guide design decisions
- Each principle with name and description
- Examples: "Clarity Above All", "Empowerment Through Simplicity", "Consistency Builds Trust", "Human-Centered"
2.0 Brand Identity
2.1 Logo Usage
- Primary logo specifications
- Clear space requirements
- Incorrect usage examples
- Minimum size requirements
- Color variations (full color, black, white)
2.2 Color Palette
- Organized table with Role, Color Name, HEX, and RGB values
- Primary colors (1-2)
- Secondary colors (1-3)
- Accent colors
- Text colors
- Background colors
- System colors (Success, Warning, Error)
- Accessibility notes for each color combination
2.3 Typography
- Heading font specifications (H1, H2, H3)
- Body text specifications
- Caption/small text specifications
- Font families, weights, sizes, and line heights in tabular format
- Web font loading considerations
- Fallback fonts
2.4 Iconography
- Icon style guidelines (outlined, filled, line weight)
- Grid system specifications
- Size variants
- Usage examples
- Link to icon library
2.5 Imagery
- Photography style guidelines
- Illustration style guidelines
- Image treatment specifications
- Do's and don'ts
- Quality requirements
3.0 Content Style Guide
3.1 Voice and Tone
- Voice characteristics (consistent attributes)
- Tone variations (how voice adapts to context)
- Examples for different scenarios
3.2 Grammar and Mechanics
- Punctuation rules
- Capitalization standards
- Voice preference (active/passive)
- Number formatting
- Date and time formatting
4.0 UI Components
4.1 Buttons
- State variants (Primary, Secondary, Tertiary, Disabled)
- Size variants
- Usage guidelines
- Code snippets (HTML/CSS)
- Accessibility requirements
4.2 Forms
- Input field specifications
- Label positioning
- Validation states
- Required field indicators
- Error message styling
- Help text formatting
4.3 [Additional Components as needed]
- Cards
- Modals
- Navigation
- Tables
- Alerts/Notifications
- Tooltips
- Badges
- Progress indicators
5.0 Layout & Grid
- Grid system specifications (columns, gutters)
- Responsive breakpoints
- Spacing scale (base unit and multipliers)
- Container widths
- Margin and padding conventions
6.0 Accessibility (A11y)
- WCAG compliance level (2.1 AA standard)
- Color contrast requirements
- Alt text guidelines
- Keyboard navigation standards
- Screen reader considerations
- Focus indicators
7.0 Resources
- Links to design files (Figma, Sketch, Adobe XD)
- Icon library location
- Illustration library location
- Font files repository
- Code repository
- Additional documentation
8.0 Changelog
- Version history with dates
- Changes summary for each version
Information Extraction Process
When analyzing provided materials, extract the following systematically:
From URLs/Websites:
- Fetch the website using web_fetch
- Analyze HTML/CSS for:
- Color values (background-color, color properties)
- Font families and typography (font-family, font-size, font-weight)
- Spacing patterns (margin, padding values)
- Component structures
- Take note of:
- Visual hierarchy
- Button styles and states
- Form element treatments
- Navigation patterns
- Responsive behavior (if observable)
From Screenshots/Images:
- Identify color palette using visual analysis
- Determine typography hierarchy
- Note spacing and layout patterns
- Identify UI component variants
- Observe design principles in practice
From Existing Documentation:
- Extract mission/vision statements
- Gather existing brand guidelines
- Collect color specifications
- Document current typography standards
- Note any existing component libraries
Creating Professional Tables
Use well-formatted tables for specifications. Example formats:
Color Palette Table:
| Role | Color | HEX | RGB |
|------------|-------------|---------|---------------|
| Primary | Brand Blue | #378DFF | 55, 141, 255 |
| Secondary | Light Blue | #A5CAFF | 165, 202, 255 |
Typography Table:
| Element | Font Family | Weight | Size (px) | Line Height |
|---------|-------------|---------|-----------|-------------|
| H1 | Inter | Bold | 48 | 1.2 |
| H2 | Inter | Bold | 36 | 1.3 |
| Body | Inter | Regular | 16 | 1.5 |
Button States Table:
| State | Appearance | Usage |
|-----------|-------------------------|--------------------------------|
| Primary | Solid fill, primary | Main call to action on a page |
| Secondary | Outline, primary color | Secondary actions |
| Tertiary | Text only | Less important actions |
PDF Generation Best Practices
Professional Formatting:
- Use consistent heading hierarchy
- Apply proper spacing between sections
- Utilize tables for structured data
- Include visual examples where possible
Typography:
- Use professional fonts (Inter, Roboto, or system fonts)
- Maintain consistent sizing hierarchy
- Ensure sufficient line height for readability
Color Usage:
- Show color swatches with hex codes
- Ensure sufficient contrast for accessibility
- Document color roles clearly
Organization:
- Number sections clearly (1.0, 1.1, 2.0, etc.)
- Include table of contents for longer guides
- Use page breaks appropriately
- Add page numbers
Accessibility:
- Ensure document is screen-reader friendly
- Use proper heading structure
- Include alt text for images
- Maintain minimum font size of 12pt
Handling Incomplete Information
When information is missing or unclear:
Make Reasonable Inferences:
- Extract colors from provided screenshots
- Infer typography from website analysis
- Estimate spacing based on visual patterns
Use Placeholders:
- "[Insert company mission statement]" for unknown content
- "[Link to design files]" for unavailable resources
- "Version 1.0" and current date as defaults
Ask Clarifying Questions:
- "What is your company's mission statement?"
- "Do you have existing brand colors or should I extract them from the website?"
- "Are there specific accessibility requirements beyond WCAG 2.1 AA?"
Provide Templates:
- Include example text for sections that need user input
- Show format for content they should provide
- Give guidance on what information would be ideal
Example User Interactions
Example 1: URL-Based Request
User: "Create a style guide for my website at example.com"
Process:
- Fetch website with web_fetch
- Analyze HTML/CSS for design system
- Extract colors, fonts, spacing
- Structure into standard template
- Generate professional PDF
- Provide download link
Example 2: Screenshot-Based Request
User: "Here are screenshots of my app. Create a style guide." [uploads images]
Process:
- Analyze images for visual elements
- Extract color palette
- Identify typography patterns
- Document component styles
- Fill in template structure
- Generate PDF with findings
- Provide download link
Example 3: Comprehensive Request
User: "Create a style guide using my website URL, these brand colors [list], and our mission statement [text]"
Process:
- Combine all provided information
- Fetch and analyze website
- Integrate provided brand elements
- Structure complete style guide
- Generate professional PDF
- Provide download link
Quality Checklist
Before delivering the style guide PDF, verify:
Resources
This skill uses the following bundled resources:
assets/template.pdf
The base template PDF that demonstrates the professional structure and formatting that all generated style guides should follow. This file serves as a reference for structure, section organization, and formatting standards.
scripts/analyze_website.py
Python script to extract design system information from websites, including colors, typography, and component patterns. Can be used to automatically gather design specifications from live URLs.
references/design_system_examples.md
Reference document containing examples of well-structured design systems and style guides from leading companies. Use this for inspiration on content organization and presentation standards.
1---2name: style-guide-generator3description: Generate comprehensive website style guides and design systems from URLs, screenshots, and existing documentation. Use this skill when users ask to create a style guide, design system documentation, brand guidelines document, or design specification from a website, app, or existing materials. This skill produces professional PDF outputs following industry-standard style guide structure.4metadata:5 source: https://skillmd.com/skills/aaaaqwq/style-guide-generator6---78# Style Guide Generator910## Overview1112Generate professionally formatted website style guides and design systems by analyzing provided URLs, screenshots, uploaded files, and user requirements. Output comprehensive PDF documents that serve as the single source of truth for design and development teams.1314## Workflow Decision Tree1516When a user requests a style guide, follow this decision tree:17181. **Gather Information**19 - If user provides URL → Use web_fetch to analyze the website20 - If user provides screenshots/images → Analyze visual elements21 - If user provides existing documentation → Extract and structure information22 - If user provides minimal information → Ask clarifying questions about brand, goals, and requirements23242. **Extract Design Elements**25 - Colors (primary, secondary, accent, text, background, success, warning, error)26 - Typography (fonts, weights, sizes, line heights)27 - Logo usage guidelines28 - Iconography style29 - Imagery preferences30 - UI component patterns31 - Layout and spacing systems32 - Accessibility requirements33343. **Structure Content**35 - Follow the standard template structure (see Template Structure section)36 - Organize extracted information into appropriate sections37 - Add mission/vision if provided or inferred38 - Document design principles39 - Create component specifications40414. **Generate PDF**42 - Use the PDF skill to create a professional document43 - Apply consistent formatting and typography44 - Include tables for color palettes, typography specs, and component states45 - Ensure accessibility with proper contrast ratios46 - Add version number and last updated date4748## Standard Template Structure4950Every style guide should follow this professional structure (based on industry best practices):5152### 1.0 Introduction53- Version number and last updated date54- Purpose and scope statement55- Target audience (design and development teams)5657### 1.1 Mission & Vision58- Company mission statement59- Company vision statement60- Strategic positioning6162### 1.2 Design Principles63- 4-6 core principles that guide design decisions64- Each principle with name and description65- Examples: "Clarity Above All", "Empowerment Through Simplicity", "Consistency Builds Trust", "Human-Centered"6667### 2.0 Brand Identity6869#### 2.1 Logo Usage70- Primary logo specifications71- Clear space requirements72- Incorrect usage examples73- Minimum size requirements74- Color variations (full color, black, white)7576#### 2.2 Color Palette77- Organized table with Role, Color Name, HEX, and RGB values78- Primary colors (1-2)79- Secondary colors (1-3)80- Accent colors81- Text colors82- Background colors83- System colors (Success, Warning, Error)84- Accessibility notes for each color combination8586#### 2.3 Typography87- Heading font specifications (H1, H2, H3)88- Body text specifications89- Caption/small text specifications90- Font families, weights, sizes, and line heights in tabular format91- Web font loading considerations92- Fallback fonts9394#### 2.4 Iconography95- Icon style guidelines (outlined, filled, line weight)96- Grid system specifications97- Size variants98- Usage examples99- Link to icon library100101#### 2.5 Imagery102- Photography style guidelines103- Illustration style guidelines104- Image treatment specifications105- Do's and don'ts106- Quality requirements107108### 3.0 Content Style Guide109110#### 3.1 Voice and Tone111- Voice characteristics (consistent attributes)112- Tone variations (how voice adapts to context)113- Examples for different scenarios114115#### 3.2 Grammar and Mechanics116- Punctuation rules117- Capitalization standards118- Voice preference (active/passive)119- Number formatting120- Date and time formatting121122### 4.0 UI Components123124#### 4.1 Buttons125- State variants (Primary, Secondary, Tertiary, Disabled)126- Size variants127- Usage guidelines128- Code snippets (HTML/CSS)129- Accessibility requirements130131#### 4.2 Forms132- Input field specifications133- Label positioning134- Validation states135- Required field indicators136- Error message styling137- Help text formatting138139#### 4.3 [Additional Components as needed]140- Cards141- Modals142- Navigation143- Tables144- Alerts/Notifications145- Tooltips146- Badges147- Progress indicators148149### 5.0 Layout & Grid150- Grid system specifications (columns, gutters)151- Responsive breakpoints152- Spacing scale (base unit and multipliers)153- Container widths154- Margin and padding conventions155156### 6.0 Accessibility (A11y)157- WCAG compliance level (2.1 AA standard)158- Color contrast requirements159- Alt text guidelines160- Keyboard navigation standards161- Screen reader considerations162- Focus indicators163164### 7.0 Resources165- Links to design files (Figma, Sketch, Adobe XD)166- Icon library location167- Illustration library location168- Font files repository169- Code repository170- Additional documentation171172### 8.0 Changelog173- Version history with dates174- Changes summary for each version175176## Information Extraction Process177178When analyzing provided materials, extract the following systematically:179180### From URLs/Websites:1811. Fetch the website using web_fetch1822. Analyze HTML/CSS for:183 - Color values (background-color, color properties)184 - Font families and typography (font-family, font-size, font-weight)185 - Spacing patterns (margin, padding values)186 - Component structures1873. Take note of:188 - Visual hierarchy189 - Button styles and states190 - Form element treatments191 - Navigation patterns192 - Responsive behavior (if observable)193194### From Screenshots/Images:1951. Identify color palette using visual analysis1962. Determine typography hierarchy1973. Note spacing and layout patterns1984. Identify UI component variants1995. Observe design principles in practice200201### From Existing Documentation:2021. Extract mission/vision statements2032. Gather existing brand guidelines2043. Collect color specifications2054. Document current typography standards2065. Note any existing component libraries207208## Creating Professional Tables209210Use well-formatted tables for specifications. Example formats:211212**Color Palette Table:**213```214| Role | Color | HEX | RGB |215|------------|-------------|---------|---------------|216| Primary | Brand Blue | #378DFF | 55, 141, 255 |217| Secondary | Light Blue | #A5CAFF | 165, 202, 255 |218```219220**Typography Table:**221```222| Element | Font Family | Weight | Size (px) | Line Height |223|---------|-------------|---------|-----------|-------------|224| H1 | Inter | Bold | 48 | 1.2 |225| H2 | Inter | Bold | 36 | 1.3 |226| Body | Inter | Regular | 16 | 1.5 |227```228229**Button States Table:**230```231| State | Appearance | Usage |232|-----------|-------------------------|--------------------------------|233| Primary | Solid fill, primary | Main call to action on a page |234| Secondary | Outline, primary color | Secondary actions |235| Tertiary | Text only | Less important actions |236```237238## PDF Generation Best Practices2392401. **Professional Formatting:**241 - Use consistent heading hierarchy242 - Apply proper spacing between sections243 - Utilize tables for structured data244 - Include visual examples where possible2452462. **Typography:**247 - Use professional fonts (Inter, Roboto, or system fonts)248 - Maintain consistent sizing hierarchy249 - Ensure sufficient line height for readability2502513. **Color Usage:**252 - Show color swatches with hex codes253 - Ensure sufficient contrast for accessibility254 - Document color roles clearly2552564. **Organization:**257 - Number sections clearly (1.0, 1.1, 2.0, etc.)258 - Include table of contents for longer guides259 - Use page breaks appropriately260 - Add page numbers2612625. **Accessibility:**263 - Ensure document is screen-reader friendly264 - Use proper heading structure265 - Include alt text for images266 - Maintain minimum font size of 12pt267268## Handling Incomplete Information269270When information is missing or unclear:2712721. **Make Reasonable Inferences:**273 - Extract colors from provided screenshots274 - Infer typography from website analysis275 - Estimate spacing based on visual patterns2762772. **Use Placeholders:**278 - "[Insert company mission statement]" for unknown content279 - "[Link to design files]" for unavailable resources280 - "Version 1.0" and current date as defaults2812823. **Ask Clarifying Questions:**283 - "What is your company's mission statement?"284 - "Do you have existing brand colors or should I extract them from the website?"285 - "Are there specific accessibility requirements beyond WCAG 2.1 AA?"2862874. **Provide Templates:**288 - Include example text for sections that need user input289 - Show format for content they should provide290 - Give guidance on what information would be ideal291292## Example User Interactions293294**Example 1: URL-Based Request**295User: "Create a style guide for my website at example.com"296Process: 2971. Fetch website with web_fetch2982. Analyze HTML/CSS for design system2993. Extract colors, fonts, spacing3004. Structure into standard template3015. Generate professional PDF3026. Provide download link303304**Example 2: Screenshot-Based Request**305User: "Here are screenshots of my app. Create a style guide." [uploads images]306Process:3071. Analyze images for visual elements3082. Extract color palette3093. Identify typography patterns3104. Document component styles3115. Fill in template structure3126. Generate PDF with findings3137. Provide download link314315**Example 3: Comprehensive Request**316User: "Create a style guide using my website URL, these brand colors [list], and our mission statement [text]"317Process:3181. Combine all provided information3192. Fetch and analyze website3203. Integrate provided brand elements3214. Structure complete style guide3225. Generate professional PDF3236. Provide download link324325## Quality Checklist326327Before delivering the style guide PDF, verify:328329- [ ] All sections are complete or marked as placeholders330- [ ] Color palette includes HEX and RGB values331- [ ] Typography specifications are detailed (family, weight, size, line height)332- [ ] Tables are properly formatted and aligned333- [ ] Accessibility requirements are documented334- [ ] Version number and date are included335- [ ] Resources section links are provided (even if placeholder)336- [ ] Changelog is started with version 1.0337- [ ] PDF is professionally formatted338- [ ] Document is ready for team distribution339340## Resources341342This skill uses the following bundled resources:343344### assets/template.pdf345The base template PDF that demonstrates the professional structure and formatting that all generated style guides should follow. This file serves as a reference for structure, section organization, and formatting standards.346347### scripts/analyze_website.py348Python script to extract design system information from websites, including colors, typography, and component patterns. Can be used to automatically gather design specifications from live URLs.349350### references/design_system_examples.md351Reference document containing examples of well-structured design systems and style guides from leading companies. Use this for inspiration on content organization and presentation standards.