Build a professional website with AI — or upgrade the one you made in Claude or ChatGPT

kiss-ssg turns a description, or a site you already have, into a website you can host anywhere, edit yourself and hand to a developer. It checks every build before it goes live. Free and open source.

npx kiss-ssg@latest init

Read the guide

What you need to build a website with AI

Install the first two before you start. The other two keep your work safe and put it online — free plans are plenty for a small site.

Node.js (opens in a new tab) Required
Runs kiss and builds your site. Version 22.23.4 or later — the LTS download is fine.
Claude Code or Codex Required
The coding agent that writes the site for you: Anthropic's Claude Code or OpenAI's Codex. Either works with kiss's skills, and each needs its own account — a Claude account for Claude Code, a ChatGPT account for Codex.
- Claude Code (opens in a new tab)
- Codex (opens in a new tab)
Git (opens in a new tab) Recommended
Keeps every version of your site, so any change can be undone. Push it to GitHub, GitLab or Bitbucket to keep a copy online — the hosts below publish straight from GitHub, and most from GitLab or Bitbucket too.
A host To go live
Puts the finished site on the web. Each builds it from your repository with npm run build and publishes the public folder; each link is that host's own guide to doing it.

From nothing to a live website in six commands

With Node.js and Claude Code or Codex installed, these do the rest.

Set it up, in a new folder
init installs kiss-ssg, adds a starter site and the build scripts, and points your agent at the API contract. For Claude Code and Codex, the three plugin lines install kiss's skills and the last line opens your agent. Pick the agent you use.
Your coding agent
Claude Code
```
mkdir my-site && cd my-site
npx kiss-ssg@latest init
claude plugin marketplace add cprobert/kiss-ssg --scope project
claude plugin install kiss-ssg@kiss-ssg --scope project
claude plugin install kiss-memory@kiss-ssg --scope project
claude
```
The plugins install for this folder. init declares them in the site's settings, but a declared plugin is not installed until these lines run.
Optional: Anthropic skills for design and testing, and Lighthouse for speed numbers
kiss decides how a site is built, not what it looks like or how it renders on a phone. One plugin from Anthropic adds both, from the site's folder:
```
claude plugin marketplace add anthropics/skills --scope project
claude plugin install example-skills@anthropic-agent-skills --scope project
```
frontend-design, for the look
It sets the visual direction: type, colour, spacing and layout character. kiss keeps the structure, which means layouts, partials, the Sass folder and one view per page.
webapp-testing, for a browser
A Playwright recipe for Python. With Playwright installed, your agent can open what it built at phone and desktop widths and in dark mode, and kiss's skills serve it the build folder over HTTP, never from file://. Install Playwright with:
```
pip install playwright
python -m playwright install chromium
```
Lighthouse, for speed numbers
Not a skill: Google's page-speed tool, as an npm package. With it, npx kiss-ssg speed public measures a built site, and the kiss-performance skill measures before and after its changes. kiss does not install it, because it is about 19 MB and needs Node 22.19 or later and a Chrome:
```
npm install -D lighthouse
```
The plugin carries ten other example skills as well. init declares neither the plugin nor Lighthouse, so installing them is your choice.
Codex
```
mkdir my-site && cd my-site
npx kiss-ssg@latest init
codex plugin marketplace add cprobert/kiss-ssg
codex plugin add kiss-ssg@kiss-ssg
codex plugin add kiss-memory@kiss-ssg
codex
```
init enables the plugins for this folder in .codex/config.toml, but Codex installs them once, for your user, and that also switches them on in every folder: your next site needs only the first two lines and codex.
Optional: Lighthouse for speed numbers
Google's page-speed tool, as an npm package. With it, npx kiss-ssg speed public measures a built site, and the kiss-performance skill measures before and after its changes:
```
npm install -D lighthouse
```
kiss does not install it: it is about 19 MB and needs Node 22.19 or later and a Chrome.
Other agent
```
mkdir my-site && cd my-site
npx kiss-ssg@latest init
```
For Cursor, Copilot and any other agent: kiss's skills install through Claude Code's and Codex's plugin systems, so yours will not have them — leave the skill names out of the prompts below. init writes AGENTS.md, which points your agent at node_modules/kiss-ssg/llms.txt; if yours does not read AGENTS.md, ask it to read that file first. Then open your agent in this folder, describe the site, and have it run npm run check.
Optional: Lighthouse for speed numbers
Google's page-speed tool, as an npm package. With it, npx kiss-ssg speed public measures a built site, before and after a change:
```
npm install -D lighthouse
```
kiss does not install it: it is about 19 MB and needs Node 22.19 or later and a Chrome.
Say what you want
In your agent, paste one of these.
- A new site
  Change the business, the host and the address: kiss writes the sitemap, the feed and every canonical link from them.
  Use the kiss-site-new skill to build me a site for a small bakery in Leeds: home, menu, about, and a news section for seasonal specials. It will be served by Netlify at https://kirkgate-bakery.co.uk. Run the build check when you're done.
- A site you made in Claude or ChatGPT
  kiss is its upgrade path. Paste the link to the published artifact or share in place of the one below — or, if you have it as an HTML file, put it in the folder and name the file instead.
  Use the kiss-site-import skill to turn https://claude.ai/public/artifacts/… into a real site, keeping exactly how it looks. Run the build check when you're done.
See it, and check it
npm run dev serves the site with live reload at the address it prints (localhost:3001 by default) and keeps running — Ctrl-C to stop. npm run check reports every page, broken link and missing launch detail, and publishes nothing: exit 0 means it's right. npm run build writes the site to public/ to deploy.
```
npm run dev
npm run check
```

kiss is the upgrade path for a site you made in Claude or ChatGPT: converting keeps it looking exactly the same and gives it a layout, partials and content a web developer could take over: how converting works.

Why kiss-ssg suits AI coding agents

Conventions, not questions
Folders, routes, helpers and asset names all have defaults, so an agent has fewer choices to get wrong, and every default can be overridden.
A verdict, not a log
A failed page or a link to a page that doesn't exist fails the build. Mistakes can't ship quietly.
Readable by the next person
Handlebars views, JSON models and small controllers. Whoever opens the site in two years can follow what the agent wrote.
A memory of the site
npx kiss-ssg aikb records what the site is, so the next session starts from facts rather than guesses.
Skills for every job on the site
kiss's skills give your agent a recipe for each job (a new site, a new page, a launch review, an upgrade) and the web know-how behind it: writing, structure, search, accessibility, front end and design. The skills decide; the engine checks.
What the skills do

Websites built with kiss-ssg

Diploma MSc (opens in a new tab)
Online postgraduate certificates, diplomas, MScs and MBAs for healthcare professionals, delivered with university partners including the University of Buckingham.
A1K9 Training (opens in a new tab)
Gaynor Probert's dog behaviour and training academy: weekend group courses at Pontarddulais, and behaviour consultations at the academy or at home.
Pro Plumbing (opens in a new tab)
Greg Probert's plumbing business in Aberdare and the Cynon Valley: small jobs and bigger installs, booked by WhatsApp or a call-back.
K9 Solutions (opens in a new tab)
One-to-one dog training in Merthyr Tydfil: practical coaching for puppies, family dogs and problem behaviour, at Cyfarthfa Park, at home or remotely.
Learna (opens in a new tab)
Online postgraduate education for medical and business professionals: PGDips, MScs, exam revision and an eMBA, across a medical school and a business school.