let-an-agent-build-your-blog

v0.2.0

Published

a month ago

A small, typed static site generator where content is a contract and presentation is fully agent-customizable.

0High
0Medium
0Low

trebaud

Let an agent build your blog

A small static site generator (Bun + TypeScript) optimized for LLM agents.

No template DSL — a component is a function that takes typed content and returns an HTML string. The whole look lives in a few small functions, so an agent can rewrite the presentation layer without touching your writing or the build engine.

Quick start

Requires Bun 1.x.

bunx let-an-agent-build-your-blog my-blog
cd my-blog
bun dev   # build + watch + serve at http://localhost:3000 (drafts included)

Skip the theme prompt with a flag:

bunx let-an-agent-build-your-blog my-blog --theme cosmic   # premade theme
bunx let-an-agent-build-your-blog my-blog --theme custom   # design it with an agent
bunx let-an-agent-build-your-blog --list                   # list themes

custom scaffolds the base theme and prints the command to run the customize skill in Claude Code, Codex, Pi, or any other agent.

How it's organized

content/  →  core/ (parse)  →  site/ (render)  →  public/

content/ — posts and pages (Markdown + frontmatter). Frontmatter contract: content/README.md.
core/ — the build engine. Don't edit.
site/ — the active theme: site.config.ts, components/, styles/index.css. Yours to rewrite.

Each premade theme is its own branch, so on any branch site/ holds exactly one theme — nothing for an agent to confuse it with.

Customizing with an agent

The repo ships a customize skill at .claude/skills/customize/ (mirrored under .agents/). Describe the look and let it drive — it edits site/ only: