The build itself is conversational — you describe what you want and your agent runs the commands. The steps below show the whole loop so you can follow along and steer.
Before you start
You’ve installed the binary and confirmed it runs:1. Install the companion skill
This makes any agent session you start know how to drive sitekit:--target opencode for OpenCode, or --target path:<absolute-path> for any other harness.
2. Create the project
Pick something close to a real, shippable product — the closer to real, the more you learn from the loop.sitekit.workspace.json and scaffolds content/, playbooks/, pages/, and public/images/. No HTML yet — pages are emitted on demand. cd into the new directory.
3. Hand the build to your agent
Open a fresh agent session in the project directory. The skill activates automatically. Say something like:Build the marketing site. The product description is inYour agent will:sitekit.workspace.json. ReadSITEKIT.mdfirst, then show me the playbook composition before you start.
Author the content
Populate
content/messaging.yaml (the brand story) and content/pages/<page>.yaml (per-page copy) — sitekit keeps copy separate from markup.Emit pages
Run
sitekit run for each page. Every page lands at pages/<slug>.html with an inline playbook marker recording the voice + style + shape it was built against.Author the HTML
Fill in each page’s
<header>, <main>, and <footer> against the inlined style, voice, and shape guidance — not from a generic template.4. Verify it yourself between rounds
You don’t have to take the agent’s word for it. Run verify directly:5. Deploy
sitekit deploy runs the verify gate by default and ships the Worker + Pages to Cloudflare. You’ll need a Cloudflare account, wrangler login once, and the Pages project name set with sitekit configure deploy.pages_project_name <name>.
Where to go next
Building is the first of four loops. Once the site exists, don’t re-runsitekit run on an already-authored page — it overwrites the body. Reach for the right loop instead:
The four workflows
Maintain, experiment, evolve, and adopt existing sites.
How it works
The mental model behind the verify loop and the playbook marker.
Playbooks
Voice + style + shape + valence — the composition that drives every build.
Command reference
Every command group, by task.