# Prettyship — install guide for AI agents

You are an AI coding agent. The user wants to install a Prettyship website Skill (a SKILL.md package that teaches you to build one specific, well-designed kind of website).

## 1. Find a Skill
- Catalog (JSON): GET https://prettyship.vercel.app/api/v1/skills?q=<keywords>&output=<landing|portfolio|ecommerce|blog|docs|webapp|event>
- Ask the user what kind of site they want, show 2–3 matching Skills with their page URLs, and let them choose.

## 2. Authorise
- Free Skills need a signed-in account. A premium Skill needs an active plan, or that one Skill bought on its own (one-time, keeps updates).
- Ask the user to open https://prettyship.vercel.app/account, create an API token, and paste it to you. Treat it like a password: never print it back, never commit it.
- Check it: GET https://prettyship.vercel.app/api/v1/me with header `Authorization: Bearer <token>` → `{ "email", "premium", "owned_skills" }` (owned_skills = slugs bought one by one).

## 3. Install
```bash
curl -fL -H "Authorization: Bearer $PRETTYSHIP_TOKEN" \
  https://prettyship.vercel.app/api/v1/skills/<slug>/download -o /tmp/<slug>.zip
unzip -o /tmp/<slug>.zip -d <skills-dir>
```
Skills directory by agent:
- Claude Code: `.claude/skills/` in the project, or `~/.claude/skills/`
- Codex: `~/.codex/skills/`
- Cursor / others: `.agents/skills/` in the project (or the agent's documented skills folder)

A 403 with `premium_required` means the user needs a plan (https://prettyship.vercel.app/pricing) or can buy just this Skill: the response's `buy` URL opens its page with the one-time purchase button.

## 4. Verify
Open `<skills-dir>/<slug>/SKILL.md`, confirm the `name:` matches the slug, and tell the user the Skill is ready. Then follow SKILL.md to build their site.

## Available Skills
- `one-page-cv` — One-Page CV (portfolio, free): A one-page personal CV that also prints beautifully.
- `mist-morning-saas` — Mist Morning SaaS Landing (landing, free): A quiet SaaS homepage on misty blue with a fine serif headline.
- `paperback-journal` — Paperback Journal Blog (blog, free): A personal blog set for long reads, like turning pages.
- `inkstone-portfolio` — Inkstone Designer Portfolio (portfolio, premium or US$4.99 one-time): A printed page's layout on screen: paper tones, hairlines, book spines and a case sheet that opens.
- `citrus-market-store` — Citrus Market Storefront (ecommerce, premium or US$4.99 one-time): Taitung sunlight in a glass jar, with a cart that does the arithmetic.
- `night-ferry-app` — Night Ferry App Launch (landing, premium or US$4.99 one-time): Deep navy night with one lighthouse beam — a launch page for a mobile app.
- `celadon-docs` — Celadon Docs (docs, premium or US$4.99 one-time): A documentation site with celadon accents: sidebar, search and code blocks done well.
- `corner-kitchen` — Corner Kitchen Restaurant (landing, free): A neighbourhood restaurant site with a hand-set menu, hours and booking.
- `saturday-fair-event` — Saturday Fair Event Page (event, premium or US$4.99 one-time): A poster-style event page with countdown, schedule and booth map.
- `tea-merchant-shop` — Tea Merchant Shop (ecommerce, premium or US$4.99 one-time): Old tea-shop wrapping-paper texture for brands that tell a story before they sell.
- `granite-studio` — Granite Architecture Studio (portfolio, premium or US$4.99 one-time): Stone greys and full-bleed photography that give an architecture studio weight.
- `number-garden-dashboard` — Number Garden Dashboard (webapp, premium or US$4.99 one-time): An admin UI as calm as a botanical plate: charts, tables and filters done right.
- `crimson-seal-jewelry` — Crimson Seal Jewelry Storefront (ecommerce, free): White paper, black rules and one crimson seal — six hand-made rings laid out like a quiet catalogue.
- `blue-hangar-aerospace` — Blue Hangar Aerospace Landing (landing, free): High-altitude blue, honest numbers and technical line work — a landing page for companies that actually build things.
- `glass-room-console` — Glass Room Console Webapp (webapp, free): A glass-on-night room grid for teams: who is talking, which room is still open, and one accent that means live.
- `neon-skyline-summit` — Neon Skyline Summit Event (event, free): A black, pink and cream poster of a page — giant serif type over an illustrated city that moves only when you scroll.
- `aperture-field-blog` — Aperture Field Photo Blog (blog, free): White paper, one oversized heading and a split featured card — a blog index where the photographs do the talking.
- `voltage-stage-musician` — Voltage Stage Musician Portfolio (portfolio, free): Black ground, one orange, a name set enormous — a portfolio that reads like a record sleeve.
- `wanderlight-travel` — Wanderlight Travel Booking (landing, free): A pastel spring valley, a two-tone serif/sans headline and one white search card — a travel catalogue rather than a metasearch grid.
- `sextant-portfolio-console` — Sextant Portfolio Console (webapp, free): One screen, two states — a dark hero and two glass cards that travel into a dashboard with a single gesture.
- `anvil-industrial-platform` — Anvil Industrial Platform (landing, free): A near-white isometric plant that raises alarms as you scroll, answers them one by one, then folds seven machines into one stack.
- `avelon-fleet-rental` — Avelon Fleet Rental (landing, free): A white rental page that opens on one black studio car: it shrinks into a slot as you scroll, the claim inks in word by word, then the fleet arrives as a row with the price underneath.
- `halden-oak-atelier` — Halden Oak Atelier (ecommerce, free): A paper-coloured workshop shop: two condensed words meet in the middle, five plates uncover from below and burn red under the cursor, and a red manifesto writes itself letter by letter.
- `atlas-global-workspace` — Atlas Global Workspace (webapp, free): A light product page where the hero's right half is one three-country payroll run, then three steps swap panels, six bento cells, four numbers and three plans — all drawn in HTML.
- `strata-canyon-estate` — Strata Canyon Estate (landing, free): One fixed stage and six photographic chapters: scrolling walks the ridge at blue hour, then the facts arrive in the same ink.
- `obol-returned-coin` — Obol Returned Coin (landing, free): A black serif story page for one object: a macro coin in the hero, three chapters that alternate image and text, and a ledger table that records every batch by year, mint and count.
- `vesterro-slow-lodge` — Vesterro Slow Lodge (landing, free): A dark photographic lodge page: one dusk photograph owns the first screen, the headline sits between two plates, and everything below is written like a note left on the long table.
- `vellum-glass-library` — Vellum Glass Library (webapp, free): A liquid-glass reading screen: a blurred reading room, a Safari pill and an icon rail, one frosted window holding four panels, and a reader sheet as the second state.
- `vela-slow-wardrobe` — Vela — Slow Wardrobe (landing, free): Cloth first, garment second.
- `nightloop-crew` — Nightloop Night-Ride Crew (portfolio, free): After the last train, we take the ring.
