@kennethsolomon/shipkit 3.14.0 → 3.15.1

package/skills/sk:website/references/niche/ecommerce.md

@@ -0,0 +1,76 @@
+# Ecommerce / Product Catalog
+
+Use for product catalogs, DTC brands, product-focused storefronts, and online shops.
+
+## Priorities
+
+1. Show product value immediately — hero leads with the product.
+2. Reduce friction to browsing or buying — clear category navigation, no distractions.
+3. Build trust: shipping clarity, returns policy, real reviews if available.
+4. Support product discovery without overwhelming.
+
+## Default page set
+
+- Home (featured collection + brand story + trust signals)
+- Shop / Collections (category navigation + product grid)
+- Product detail pages (individual product pages if building a full store)
+- About (brand story + values)
+- Contact (customer support channel + FAQ link)
+
+Optional: FAQ, Blog, Wholesale inquiry, Sustainability/Story page
+
+## Section guidance
+
+**Hero:**
+- Lead with the product or collection — not a brand statement
+- Example: "Hand-poured soy candles made in Manila" + "Shop the collection" CTA
+- Featured product or hero collection image: real product photography only
+
+**Product grid / collections:**
+- Clear category structure — visitors should know where to click
+- Product card: image + name + price
+- Real products only — no placeholder "Product A"
+
+**Trust signals:**
+- Shipping: "Free shipping on orders over [X]" — only if real
+- Returns: "Easy 30-day returns" — only if true
+- Payment methods: show accepted icons (GCash, Maya, credit card, COD if applicable)
+- Review count or testimonial if real
+
+**Brand story:**
+- Why this product, who makes it, what makes it different
+- Human and specific — not "quality craftsmanship since [year]" but real details
+
+**FAQ / shipping:**
+- When will it ship, how long does delivery take, what's the return process
+- For PH: COD availability is a common question
+
+## Design guidance
+
+- **Art direction:** Premium Product-Led for considered DTC brands; Playful Contemporary for lifestyle/gift brands.
+- Product imagery is the design backbone — image quality determines conversions.
+- Typography: clean and legible for product names/prices; more expressive for brand headline
+- Palette: neutral background that makes products pop — white, cream, or dark for premium positioning
+- Don't let branding compete with the products themselves
+
+## SEO guidance
+
+- Title: "[Product Category] | [Brand Name]"
+- H1: "[Product category] — [differentiator]" e.g., "Handmade Soy Candles — Made in Manila"
+- Target: "[product type] Philippines", "[product type] online", "buy [product] [city]"
+- Each product page should have its own unique title + meta description
+- Structured data: `Product` with name, price, availability, image
+
+## WhatsApp / contact
+
+- WhatsApp for order inquiries and COD in PH — standard for smaller ecommerce brands
+- Pre-filled: "Hi! I have a question about an order / product. I found you on your website."
+- Larger stores: use a dedicated support form instead
+
+## Avoid
+
+- Placeholder products without real photos or prices
+- Shipping and returns information buried in the footer
+- Complex navigation with too many category levels
+- Invented product reviews or star ratings
+- Dense text blocks competing with product imagery

package/skills/sk:website/references/niche/gym.md

@@ -0,0 +1,75 @@
+# Gym / Fitness Studio / Trainer
+
+Use for gyms, fitness studios, yoga and Pilates studios, personal trainers, CrossFit boxes, and coaching brands.
+
+## Priorities
+
+1. Communicate training style and target audience quickly — visitors are looking for their people.
+2. Make trial, membership, or class booking paths obvious.
+3. Balance energy with clarity — fitness sites can have visual punch but still need structure.
+4. Trust through coaches, credentials, community — not invented transformation claims.
+
+## Default page set
+
+- Home (offer + training vibe + CTA)
+- Classes / Programs (schedule, class types, level descriptions)
+- Coaches / Trainers (team profiles with credentials)
+- Memberships / Pricing (clear tier comparison)
+- Contact (inquiry form + location + map)
+
+Optional: Schedule (live or embedded third-party), Gallery, Blog, FAQ
+
+## Section guidance
+
+**Hero:**
+- Set the energy immediately — who trains here and what they achieve
+- Specific: "Strength and conditioning gym in Makati for working professionals"
+- CTA: "Try a Free Class", "Book an Intro", or "Join Now"
+
+**Programs / classes:**
+- List class types with level, duration, what to expect
+- Schedule if static (or embed Mindbody/Calendly for dynamic)
+- Don't use generic fitness jargon — write for the beginner considering their first class
+
+**Coaches:**
+- Real names, photos (action or portrait), certifications, training philosophy
+- Specific credentials: NSCA, ACE, RYT, etc. — only if real
+
+**Memberships / pricing:**
+- Clear tier comparison — monthly vs. annual, class packs vs. unlimited
+- Highlight the best-value option
+- Real pricing only — never invented
+
+**Trial / inquiry CTA:**
+- Repeat on every page
+- "Try your first class free" is a high-conversion CTA for fitness
+
+## Design guidance
+
+- **Art direction:** Bold Brand-Forward (for commercial gyms), Warm Hospitality (for boutique studios), Playful Contemporary (for wellness brands).
+- Energy through color and typography — but structure must remain clear.
+- Typography: strong, confident — Clash Display, Barlow Condensed, DM Sans Bold
+- Palette: high contrast — dark base + vibrant accent (electric blue, neon green, coral)
+- Photography: real training environments, real members (with permission) — not stock gym photos
+- Motion: moderate — entrance animations are expected in this category
+
+## SEO guidance
+
+- Title: "[Studio Name] — [Type] Gym/Studio in [City]"
+- H1: "[Training type] gym in [City]" e.g., "Functional Fitness Gym in BGC Taguig"
+- Target: "gym in [city]", "yoga studio [city]", "personal trainer [city]", "[class type] classes near me"
+- Structured data: `SportsActivityLocation` or `LocalBusiness`
+
+## WhatsApp / contact
+
+- WhatsApp for class inquiries — common in PH/SEA fitness market
+- Pre-filled: "Hi! I found you on your website. I'd like to know more about your classes."
+- Trial class booking: simple form or WhatsApp link
+
+## Avoid
+
+- Invented transformation stories ("Lost 30lbs in 30 days!")
+- Member count or client stats without real data
+- Overanimated pages that take too long to render
+- Dense class grids with no descriptions
+- Hiding pricing — gym-shoppers compare prices and will leave if they can't find them

package/skills/sk:website/references/niche/home-services.md

@@ -0,0 +1,76 @@
+# Home Services
+
+Use for HVAC, roofing, plumbing, electrical, landscaping, cleaning, pest control, and other home service businesses.
+
+## Priorities
+
+1. Explain the service and service area in the first sentence — no ambiguity.
+2. Make calling or requesting an estimate as easy as possible — phone number always visible.
+3. Build trust fast with grounded, specific proof.
+4. Keep the page practical and mobile-friendly — home service searches happen from the job site or kitchen table.
+
+## Default page set
+
+- Home (service + location + phone + CTA)
+- Services (all services offered, brief description each)
+- About (who you are, how long you've operated, service area)
+- Contact / Get a Quote (form + phone + service area map)
+- FAQ (common questions about the service, pricing, process)
+
+Optional: Service area pages, Testimonials (real only), Before/After Gallery
+
+## Section guidance
+
+**Hero:**
+- Service + location + CTA in the first 5 seconds
+- Example: "Professional Plumbing Services in Metro Manila — 24/7 Emergency Available"
+- Two CTAs: "Call Now: [Phone]" (primary) + "Get a Free Quote" (secondary)
+- Emergency availability if applicable
+
+**Services:**
+- List every service with a 1–2 sentence description
+- Avoid technical jargon — say "pipe repair" not "PEX manifold replacement"
+- Note if emergency/same-day service is available
+
+**Why choose us:**
+- Specific: years in business, number of jobs completed (if real), licensed/insured status
+- Response time: "We respond within 2 hours" — only if true
+- Guarantee: only if it's a real policy
+
+**Service areas:**
+- List cities/municipalities clearly
+- Map embed if helpful
+
+**Contact / quote:**
+- Phone number in hero AND footer AND contact page
+- Simple form: Name, Phone, Service needed, Address, Brief description
+- Response time expectation
+
+## Design guidance
+
+- **Art direction:** Restrained Editorial — dependable, direct, professional.
+- Practical clarity beats visual novelty for home services.
+- Typography: clean and readable — Inter, Source Sans, Lato
+- Palette: trustworthy — navy, forest green, slate blue, or charcoal + white + one accent
+- Photography: real job photos, real team, real vehicles — stock construction imagery is acceptable but real is better
+
+## SEO guidance
+
+- Title: "[Service] in [City] | [Company Name]"
+- H1: "[Service Type] in [City/Area]" — e.g., "Licensed Electrician in Quezon City"
+- Target: "[service] in [city]", "emergency [service] near me", "[service] [city] price"
+- Service area sub-pages for major cities if operating across multiple areas
+- Structured data: `LocalBusiness` with service area, telephone, address, hours
+
+## WhatsApp / contact
+
+- WhatsApp for quick job inquiries in PH/SEA — very common for tradespeople
+- Pre-filled: "Hi! I need [service type]. I found you on your website."
+- Phone always in the nav/header for emergency calls
+
+## Avoid
+
+- Hiding the phone number
+- No emergency contact for businesses that offer emergency services
+- Invented certifications or guarantees
+- Too much design — this category values function and trust over aesthetics

package/skills/sk:website/references/niche/law-firm.md

@@ -0,0 +1,75 @@
+# Law Firm
+
+Use for law firms, solo attorneys, legal practices, and legal service brands.
+
+## Priorities
+
+1. Establish credibility and professionalism immediately — trust is the primary conversion factor.
+2. Clarify practice areas and who the firm serves — visitors self-qualify before calling.
+3. Make consultation paths obvious — phone and contact form above the fold.
+4. Use trust signals carefully and truthfully — no invented outcomes or rankings.
+
+## Default page set
+
+- Home (positioning + practice areas + consultation CTA)
+- Practice Areas (or individual pages per area for larger firms)
+- About / Our Team (attorney profiles + credentials)
+- Contact (consultation request form + phone + office address)
+- FAQ (common questions per practice area)
+
+Optional: Case Results (only with real data), Blog/Articles, Testimonials (only real ones)
+
+## Section guidance
+
+**Hero:**
+- Clear positioning: who you serve + primary practice area + location
+- Headline: specific and credible — e.g., "Criminal Defense Attorneys in Houston, Texas"
+- Primary CTA: "Schedule a Free Consultation" or "Call Now"
+
+**Practice areas:**
+- List with brief description of each area — what types of cases, who qualifies
+- Link each to a dedicated page for SEO depth
+
+**Why choose us / differentiators:**
+- Specific: years in practice, notable credentials, bar admissions, jurisdictions covered
+- Never invent: no made-up case outcomes, invented "99% success rates", unverifiable claims
+
+**Attorney profiles:**
+- Full name, photo (professional), bar admissions, practice focus, education if relevant
+- Human tone — not just a resume block
+
+**Consultation CTA:**
+- Phone number prominently placed
+- Simple form: Name, Email, Phone, Brief description of matter, Preferred contact time
+- Note if initial consultation is free
+
+## Design guidance
+
+- **Art direction:** Restrained Editorial or Premium Product-Led — both work for legal.
+- Never use Bold Brand-Forward — contradicts the professional credibility expected.
+- Typography: stable, authoritative — Lato, Source Serif, Libre Baskerville, or similar.
+- Palette: navy, charcoal, white, warm grey — one accent (deep blue, forest green, or warm gold).
+- Motion: none or subtle — law firm sites should feel stable, not animated.
+- Photography: real attorney headshots if available; avoid cheesy "handshake" stock photos.
+
+## SEO guidance
+
+- Homepage title: "[Law Firm Name] — [Primary Practice] Attorneys in [City, State]"
+- H1: "Experienced [Practice Area] Lawyers in [City]"
+- Target: "[practice area] attorney [city]", "[practice area] lawyer near me"
+- Structured data: `LegalService` schema with address, telephone, areaServed
+- Separate pages per practice area help SEO significantly
+
+## WhatsApp / contact
+
+- WhatsApp appropriate for PH/SEA firms; less common for US/AU/UK
+- Phone number always prominently visible (clients in distress call, not fill forms)
+- Form should include a "brief description of your legal matter" field
+
+## Avoid
+
+- Invented case outcomes ("$10M settlement" when it's unverifiable)
+- Generic legal stock photography (scales of justice, courthouse columns)
+- Startup-style visual aesthetics — contradicts expected professionalism
+- Burying the phone number
+- Any claims that could be considered false advertising under bar rules

package/skills/sk:website/references/niche/local-business.md

@@ -0,0 +1,78 @@
+# Local Business (Default)
+
+Use this as the default fallback for any service business tied to a city or region that doesn't match a more specific niche guide.
+
+Applies to: appointment-based services, neighborhood shops, local professional services, tradesperson businesses, community-oriented brands.
+
+## Priorities
+
+1. Explain the service and service area immediately — no ambiguity.
+2. Make contacting or booking simple — visible phone, form, or WhatsApp above the fold.
+3. Build trust with concrete local signals — not vague claims.
+4. Mobile-first — local searches happen on phones.
+
+## Default page set
+
+- Home (service + location + CTA + key trust signals)
+- Services (what you offer + brief descriptions + pricing approach if applicable)
+- About (who you are, your background, why local)
+- Contact (phone, form, address, map, hours)
+- FAQ (common questions, pricing transparency, process)
+
+## Section guidance
+
+**Hero:**
+- Service + Location in the first sentence: "Professional [Service] in [City]"
+- CTA: "Get a Free Quote", "Book Now", "Call Us", or "Contact Us"
+- Phone number visible — many local customers call directly
+
+**Services overview:**
+- List what you offer clearly — names, brief description, who it's for
+- Avoid jargon your customer wouldn't use
+
+**Why choose us:**
+- Specific: years in business, service area, response time, guarantee
+- Nothing invented
+
+**Service areas:**
+- List the cities, neighborhoods, or regions served
+- A simple paragraph or tag list is enough
+
+**Trust signals:**
+- If real: certifications, licenses, affiliations, review counts
+- Google review widget or "4.8 stars on Google" if verifiable
+
+**Contact block:**
+- Phone + email + address (if physical)
+- Hours
+- Simple form: Name, Phone/Email, Message
+- Map embed
+
+## Design guidance
+
+- **Art direction:** Restrained Editorial or Warm Hospitality depending on type.
+- Clarity always beats trendiness for local businesses.
+- Trust-first: professional photography, real team photos if available.
+- Typography: clean, readable — avoid display fonts that sacrifice legibility.
+- Palette: grounded and professional — navy, forest green, slate, warm white.
+
+## SEO guidance
+
+- Title: "[Service] in [City] | [Business Name]"
+- H1: "[Service Type] in [City/Neighborhood]"
+- Target: "[service] in [city]", "[service] near me", "[service] [neighborhood]"
+- Structured data: `LocalBusiness` with full address, telephone, hours, areaServed
+- Footer: address, phone, hours always visible for local SEO signals
+
+## WhatsApp / contact
+
+- Default: inject WhatsApp for all local businesses in PH/SEA
+- Phone number in nav/header, not buried
+- Simple form for non-urgent inquiries
+
+## Avoid
+
+- Hiding the phone number
+- Vague hero copy that doesn't state what the business does
+- Overdesigned layouts that reduce trust
+- Invented reviews, certifications, or business claims

package/skills/sk:website/references/niche/med-spa.md

@@ -0,0 +1,78 @@
+# Med Spa / Aesthetics Clinic
+
+Use for med spas, aesthetic clinics, injectables studios, skin clinics, and wellness beauty businesses.
+
+## Priorities
+
+1. Build trust and premium appeal simultaneously — both are required.
+2. Make services and booking paths obvious.
+3. Balance aspiration with clinical credibility.
+4. Keep claims careful and believable — no invented outcomes or medical guarantees.
+
+## Default page set
+
+- Home (positioning + featured treatments + booking CTA)
+- Treatments / Services (full treatment menu with descriptions)
+- About Us / Our Team (provider credentials + clinic credentials)
+- Book a Consultation (booking form or link)
+- Contact (address, hours, phone, map)
+
+Optional: Before/After Gallery (only real, consented photos), FAQ, Blog
+
+## Section guidance
+
+**Hero:**
+- Balance of aspirational and professional
+- Example: "Skin Treatments and Injectables in Bonifacio Global City"
+- CTA: "Book a Consultation" — not "Buy Now"
+- Soft, clean aesthetic — not aggressive sales
+
+**Treatments / services:**
+- List each treatment with a patient-friendly name and brief description
+- What it's for, approximate duration, when results appear
+- Group logically: Injectables, Skin, Body, Laser, etc.
+- Never invent outcomes ("Guaranteed results in 2 weeks")
+
+**Provider / clinic credentials:**
+- Doctor or RN name + credentials (MD, RN, licensed aesthetician)
+- Clinic accreditation, brand partnerships (if real)
+- Years of practice
+
+**Before/after or results:**
+- Only real photos with patient consent
+- If no real photos: skip this section — no stock before/after imagery
+
+**Booking:**
+- Initial consultation form: Name, Contact, Treatment of interest, Preferred date
+- WhatsApp for quick inquiries in PH/SEA
+
+## Design guidance
+
+- **Art direction:** Quiet Luxury or Restrained Editorial — both work well for aesthetics.
+- Premium feel without being cold or sterile.
+- Typography: refined serif or elegant sans — Cormorant Garamond, Libre Baskerville, or DM Serif Display
+- Palette: very limited — cream, warm white, blush, champagne, one muted accent
+- Photography: clean clinic environment, soft lifestyle imagery — not clinical procedure photos
+- Motion: minimal and graceful — soft fades, no rapid animations
+
+## SEO guidance
+
+- Title: "[Clinic Name] — Skin Treatments and Injectables in [City]"
+- H1: "Aesthetic Clinic in [City]" or "Med Spa in [Neighborhood], [City]"
+- Target: "med spa [city]", "botox [city]", "skin clinic near me", "fillers [city]"
+- Separate pages per treatment help for high-intent searches
+- Structured data: `MedicalBusiness` or `LocalBusiness`
+
+## WhatsApp / contact
+
+- WhatsApp common for initial inquiries in PH — patients ask questions before booking
+- Pre-filled: "Hi! I found you on your website. I'd like to book a skin consultation."
+- Consultation form for more detailed intake
+
+## Avoid
+
+- Invented before/after results or patient outcomes
+- Aggressive discount banner aesthetics (contradicts premium positioning)
+- Over-promising treatment results
+- Medical jargon without plain-language explanations
+- Stock "beauty influencer" imagery — clinical warmth beats generic glamour

package/skills/sk:website/references/niche/portfolio.md

@@ -0,0 +1,77 @@
+# Portfolio / Freelance
+
+Use for designers, developers, photographers, illustrators, writers, videographers, and any individual showcasing personal work to attract clients or opportunities.
+
+## Priorities
+
+1. Show work immediately — the work is the argument.
+2. Make it clear what you do and who you help.
+3. Reduce friction to inquiry — simple contact, not a 10-field form.
+4. Personality matters — this is a personal brand, not a corporate site.
+
+## Default page set
+
+- Home (work showcase + brief intro + CTA)
+- Work / Projects (detailed project grid or case studies)
+- About (who you are, what you specialize in, personality)
+- Contact (email link or simple form)
+
+Optional: Services (if freelance pricing/packages), Blog, Process, Resume/CV
+
+## Section guidance
+
+**Hero:**
+- First impression: your name, what you do, and who you do it for
+- Example: "Freelance product designer for SaaS startups. Based in Manila."
+- CTA: "View My Work" or "Hire Me"
+- Optional: a featured project or short reel behind the text
+
+**Work / projects:**
+- Thumbnail + project name + brief role description
+- Real work only — no placeholder "Case Study 1"
+- If work is NDA/client-confidential, show anonymized screenshots with permission
+- Link to detail pages for case studies if depth helps your field
+
+**About:**
+- Human, first-person, specific — not a job description
+- What you specialize in, what types of clients you love working with
+- Photo (optional but humanizes the brand)
+
+**Contact:**
+- Email address directly (not buried) OR a simple form
+- No need for a full inquiry form — "Name, Email, Message" is enough
+- Response time expectation if applicable ("I typically reply within 24 hours")
+
+## Design guidance
+
+- **Art direction:** Highly flexible — match to the creator's own aesthetic.
+  - Designers: Restrained Editorial or Quiet Luxury work well
+  - Developers: Sharp Technical
+  - Photographers: Premium Product-Led (image-first)
+  - Illustrators: Playful Contemporary or Bold Brand-Forward
+- The portfolio IS the design direction signal — inconsistency between the site and the work undermines credibility.
+- Typography with personality — one distinctive display face is expected.
+- Minimal navigation — most portfolios don't need more than 4 nav items.
+- Dark mode optional and often effective for portfolios.
+
+## SEO guidance
+
+- Title: "[Your Name] — [Role] based in [City]"
+- H1: "[Role] specializing in [focus area]"
+- Target: "[role] freelance", "[role] [city]", "[specialty] designer/developer"
+- Project detail pages help SEO — name the technology, client industry, and outcome
+- Structured data: `Person` schema
+
+## WhatsApp / contact
+
+- Optional for portfolios — not expected in all markets
+- For PH-based freelancers: WhatsApp is common for client initial contact
+- Keep it simple — direct number or link is enough
+
+## Avoid
+
+- Faking clients, project outcomes, or publication features
+- "Available for hire" in the hero when you're not currently available
+- Cluttered project grids with no visual hierarchy
+- Effects that distract from the actual portfolio work
+- Overly long bio — be specific, not exhaustive

package/skills/sk:website/references/niche/real-estate.md

@@ -0,0 +1,72 @@
+# Real Estate Agent / Property
+
+Use for real estate agents, brokerages, property advisors, buyer's agents, and development marketing sites.
+
+## Priorities
+
+1. Build personal or brand trust quickly — people choose agents they trust with large decisions.
+2. Make listings, inquiry, or valuation CTAs obvious.
+3. Support location-based discovery — people search by area.
+4. Present market expertise without sounding inflated.
+
+## Default page set
+
+- Home (positioning + market expertise + featured listings/inquiry CTA)
+- Listings / Properties (property grid or search)
+- About / Our Team (agent profiles + credentials + track record)
+- Buyer / Seller Services (process, what you do, who you help)
+- Contact (inquiry form + phone)
+
+Optional: Sold/Leased Properties (with client permission), Market Updates/Blog, Neighborhoods guide
+
+## Section guidance
+
+**Hero:**
+- Who you help + what market you work in
+- Example: "BGC and Makati Condo Specialist — Helping Buyers and Sellers Since 2015"
+- CTA: "Search Listings", "Request a Valuation", or "Get in Touch"
+
+**Featured listings / property highlights:**
+- Real properties only — never placeholder listings
+- Photo + property type + location + price range (or "price on request")
+
+**Why work with us:**
+- Specific: areas covered, years of experience, notable transactions if real and permitted
+- Market expertise: "We've closed 40+ transactions in BGC over 5 years" — only if true
+
+**Agent profile:**
+- Real headshot, full name, license number if applicable, areas covered
+- Brief personal approach to real estate — not just credentials
+
+**Buyer / seller services:**
+- Walk through the process — buyers and sellers have different journeys
+- What you do at each step, what makes you different from other agents
+
+## Design guidance
+
+- **Art direction:** Premium Product-Led or Restrained Editorial — property is visual, let it lead.
+- Photography quality matters most — no low-res property shots.
+- Typography: clean and professional — avoid flashy display fonts.
+- Palette: neutral, aspirational — warm whites, slate, charcoal, one sophisticated accent.
+- Luxury properties: Quiet Luxury direction is appropriate.
+
+## SEO guidance
+
+- Title: "[Agent/Firm Name] — [City] Real Estate Agent"
+- H1: "Real Estate Agent in [City/Neighborhood]"
+- Target: "real estate agent [city]", "property for sale [city]", "buy condo [city]"
+- Neighborhood guide pages help SEO long-term
+- Structured data: `RealEstateAgent` or `LocalBusiness`
+
+## WhatsApp / contact
+
+- WhatsApp for property inquiries in PH/SEA — standard practice
+- Pre-filled: "Hi! I found you on your website. I'd like to inquire about a property."
+- Phone always prominently visible
+
+## Avoid
+
+- Invented transaction volumes or rankings
+- Luxury aesthetic for non-luxury market segments (creates trust mismatch)
+- Listings without real photos (use a "coming soon" placeholder or skip the section)
+- Cluttered homepage with too many property cards