site-specification
starsforks
How to install site-specification?
automattic/wordpress-agent-skills/site-specification
$npx -y skills add Automattic/wordpress-agent-skills --skill site-specificationExtract comprehensive site specifications from simple descriptions. Use when analyzing a user's theme request to determine site type, audience, tone, layout requirements, and typography.
SKILL.md
| 1 | # Site Specification Skill |
| 2 | |
| 3 | Extract detailed site specifications from user descriptions to guide theme generation. If the user has provided images, image urls or other documents, analyze them for additional clues about the brand and design preferences - obviously things like an exising logo image can be very informative about the brand's aesthetic, tone, and values, and any written documents can contain explicit statements about the brand identity or design preferences. |
| 4 | |
| 5 | ## Site Spec Schema |
| 6 | |
| 7 | A complete site specification uses this JSON structure: |
| 8 | |
| 9 | ```json |
| 10 | { |
| 11 | "siteBrief": { |
| 12 | "siteName": "Name of the site/business", |
| 13 | "siteType": "Type of site (e.g., e-commerce, portfolio, blog, SaaS, restaurant)", |
| 14 | "primaryGoal": "Main purpose or conversion goal of the site", |
| 15 | "audience": "Target audience description", |
| 16 | "tone": "Voice and tone for the content", |
| 17 | "brandKeywords": "Keywords describing the brand aesthetic and values" |
| 18 | }, |
| 19 | "layoutNotes": [ |
| 20 | "Each layout requirement as a separate string", |
| 21 | "Sections, features, and visual elements" |
| 22 | ], |
| 23 | "typography": { |
| 24 | "primaryFont": "Main font for headings", |
| 25 | "secondaryFont": "Font for body text", |
| 26 | "usage": "How fonts should be applied", |
| 27 | "fontImport": "Google Fonts import URL" |
| 28 | } |
| 29 | } |
| 30 | ``` |
| 31 | |
| 32 | All fields are optional - only include what can be reasonably inferred from the user's description. |
| 33 | |
| 34 | ## Inference Patterns by Site Type |
| 35 | |
| 36 | ### SaaS / Technology |
| 37 | |
| 38 | **Infer:** |
| 39 | - Primary goal: Drive signups or demo requests |
| 40 | - Audience: Technical decision-makers, developers, or business users |
| 41 | - Tone: Professional, innovative, trustworthy |
| 42 | - Brand keywords: Modern, efficient, powerful, seamless |
| 43 | |
| 44 | **Typical layout:** |
| 45 | - Hero with value proposition and CTA |
| 46 | - Feature grid or comparison |
| 47 | - Social proof (logos, testimonials) |
| 48 | - Pricing section |
| 49 | - FAQ |
| 50 | - Final CTA |
| 51 | |
| 52 | **Typography tendency:** |
| 53 | - Clean geometric sans-serifs |
| 54 | - Strong hierarchy for scanning |
| 55 | - Consider: Satoshi, Plus Jakarta Sans, Outfit |
| 56 | |
| 57 | ### E-commerce / Retail |
| 58 | |
| 59 | **Infer:** |
| 60 | - Primary goal: Drive purchases |
| 61 | - Audience: Consumers with specific interests |
| 62 | - Tone: Varies by brand (luxury vs. casual vs. value) |
| 63 | - Brand keywords: Depends on positioning |
| 64 | |
| 65 | **Typical layout:** |
| 66 | - Hero with featured products or promotion |
| 67 | - Category navigation |
| 68 | - Featured products grid |
| 69 | - Trust signals (reviews, guarantees) |
| 70 | - Newsletter signup |
| 71 | |
| 72 | **Typography tendency:** |
| 73 | - Match to brand positioning |
| 74 | - Luxury: refined serifs |
| 75 | - Modern: geometric sans |
| 76 | - Playful: display fonts |
| 77 | |
| 78 | ### Professional Services (Law, Finance, Consulting) |
| 79 | |
| 80 | **Infer:** |
| 81 | - Primary goal: Generate inquiries or establish credibility |
| 82 | - Audience: Business decision-makers, individuals seeking expertise |
| 83 | - Tone: Professional, authoritative, trustworthy |
| 84 | - Brand keywords: Expertise, integrity, established, reliable |
| 85 | |
| 86 | **Typical layout:** |
| 87 | - Hero with credentials or value statement |
| 88 | - Services/practice areas |
| 89 | - Team profiles |
| 90 | - Case studies or results |
| 91 | - Testimonials from clients |
| 92 | - Contact/consultation CTA |
| 93 | |
| 94 | **Typography tendency:** |
| 95 | - Traditional serifs for headings (credibility) |
| 96 | - Clean sans-serif for body (readability) |
| 97 | - Consider: Cormorant Garamond, DM Serif Display, Source Sans Pro |
| 98 | |
| 99 | ### Restaurant / Food Service |
| 100 | |
| 101 | **Infer:** |
| 102 | - Primary goal: Drive reservations or visits |
| 103 | - Audience: Local diners, food enthusiasts |
| 104 | - Tone: Warm, inviting, appetite-inducing |
| 105 | - Brand keywords: Fresh, handcrafted, cozy, authentic |
| 106 | |
| 107 | **Typical layout:** |
| 108 | - Hero with appetizing food imagery |
| 109 | - Menu sections |
| 110 | - About/story |
| 111 | - Location and hours |
| 112 | - Reservation CTA |
| 113 | - Instagram or gallery |
| 114 | |
| 115 | **Typography tendency:** |
| 116 | - Display fonts for personality |
| 117 | - Readable serif or sans for menus |
| 118 | - Consider: Playfair Display, Lora, Josefin Sans |
| 119 | |
| 120 | ### Creative / Portfolio |
| 121 | |
| 122 | **Infer:** |
| 123 | - Primary goal: Showcase work and attract clients |
| 124 | - Audience: Potential clients, art directors, collaborators |
| 125 | - Tone: Creative, distinctive, personality-driven |
| 126 | - Brand keywords: Original, crafted, artistic, unique |
| 127 | |
| 128 | **Typical layout:** |
| 129 | - Full-bleed portfolio hero |
| 130 | - Project gallery or case studies |
| 131 | - About/bio section |
| 132 | - Services offered |
| 133 | - Contact or inquiry form |
| 134 | |
| 135 | **Typography tendency:** |
| 136 | - Distinctive display fonts |
| 137 | - Personal to the creator's style |
| 138 | - Consider: Clash Display, Fraunces, Syne |
| 139 | |
| 140 | ### Blog / Media |
| 141 | |
| 142 | **Infer:** |
| 143 | - Primary goal: Engage readers and build audience |
| 144 | - Audience: Readers with specific interests |
| 145 | - Tone: Varies by niche (authoritative, casual, entertaining) |
| 146 | - Brand keywords: Informative, engaging, credible |
| 147 | |
| 148 | **Typical layout:** |
| 149 | - Featured post hero |
| 150 | - Recent posts grid or list |
| 151 | - Category navigation |
| 152 | - About the author |
| 153 | - Newsletter signup |
| 154 | - Popular/trending section |
| 155 | |
| 156 | **Typography tendency:** |
| 157 | - Readable body fonts (critical for long-form) |
| 158 | - Clean heading fonts |
| 159 | - Consider: Merriweather, Source Serif Pro, DM Sans |
| 160 | |
| 161 | ### Non-profit / Organization |
People who liked this also viewed
6 picksType
- find-skillsHelps users discover and install agent skills when they ask questions like "how do I do X", "find a skill for X", "is there a skill that can...", or express interest in extending capabilities. This skSkillsJul 2026
- grill-meA relentless interview to sharpen a plan or design.SkillsJul 2026
- vercel-react-best-practicesVercel's official collection of agent skillsSkillsJul 2026
- improve-codebase-architectureScan a codebase for deepening opportunities, present them as a visual HTML report, then grill through whichever one you pick.SkillsJul 2026
- setup-matt-pocock-skillsConfigure this repo for the engineering skills — set up its issue tracker, triage label vocabulary, and domain doc layout. Run once before first use of the other engineering skills.SkillsJul 2026
- triageMove issues and external PRs through a state machine of triage roles — categorise, verify, grill if needed, and write agent-ready briefs.SkillsJul 2026
