Skip to main content
See the builds

Astro sites built with an agent and 20 skills

Each build here comes with the skills the agent loaded, the project record it kept and the checks that had to pass before it could deploy.

See the buildsRead the method

Written for designers and developers moving to Astro.

One project record per build

The agent reads project.md before it writes code, and writes to it as it works: the spec, the plan, each decision I made and every check it ran.Read the method

Fixed once, for every build

When I correct the agent, the fix goes into a skill or my global instructions with its date, so the next project starts with it.

  • Deploys run from GitHub Actions behind a test job
  • Card layouts switch on the card's own width
  • Private demos get Cloudflare Access before the first deploy

The method in 3 steps. The same on every build.

Step 1: Start each build with its record

The agent creates project.md before any code, with the decisions still open listed.

Step 2: Stop the build at decision gates

The agent chooses how to build. A look, a dependency or a new service comes back to me.

Step 3: Gate each build on npm test

GitHub Actions runs npm test. Only a pass reaches wrangler deploy on Cloudflare Workers.

The skills behind every build. One repo, versioned in Git.

The Astro build playbook

astro-build-playbook picks the baseline, content, forms, hosting and checks for each project.

One skills repo, four agents

One setup script links the same skills into Claude Code, Codex, Gemini CLI and the Agents CLI.

Audits of the rendered page

design-audit measures layout and type against the design; accessibility-audit tests WCAG 2.2.

Corrections in the instructions

A fix I give once is written into the instructions with its date, and every agent loads it.

The builds so far

Five Astro sites, each on its own subdomain and repo.

Get in touch

Questions about the skills, the method or one of the builds? Send a message and I'll reply by email.

All fields are required. I'll only use your email to reply.

Prefer not to use this form? Use the contact form on grahamcrosbie.com.