build-site

Assemble production-ready website files from scaffold data and design tokens.

Updated Apr 20, 2026
One-click install
npx skills add https://github.com/calebaero/website-factory --skill build-site
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: build-site
Source: https://github.com/calebaero/website-factory/tree/main/skills/build-site
Command: npx skills add https://github.com/calebaero/website-factory --skill build-site

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Takes a scaffolded project and turns it into a coherent, production-ready website by implementing routes, sections, content structure, nav/footer, design tokens, forms, gallery, FAQ, local SEO, motion, and interactive elements — while resolving all [REPLACE_WITH_*] tokens and upgrading placeholder content when the brief allows AI drafting.

Core Features & Use Cases

  • End-to-end site assembly from scaffold to deploy-ready files, respecting starter contracts and brief constraints.
  • Token resolution and content upgrading: replaces placeholders like [REPLACE_WITH_*] using brief data and design-tokens.
  • Lightweight CMS-agnostic build: does not wire CMS, run QA, or deploy; focuses on code and on-disk content.
  • Flexible design tokens sweep and responsive tokens integration for design system consistency.
  • Supports multiple starter archetypes and respects feature flags.

Quick Start

Initiate the build-site workflow against a scaffolded site directory to generate complete site artifacts.

Frequently Asked Questions about build-site

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I turn a scaffolded project into a production-ready website?

To build a production-ready website from a scaffold, coordinate the site marker, manifest, content-seed, design-tokens, and brief data to generate routes, sections, tokens, and SEO defaults. This process assembles deploy-ready files while respecting starter contracts and feature flags.

How do I resolve placeholder tokens like [REPLACE_WITH_*] during site generation?

Resolving placeholder tokens involves sweeping the brief and design-tokens to replace [REPLACE_WITH_*] markers with production copy. AI drafting upgrades placeholders only when the contentSource feature flag permits it; otherwise, seed TODOs are preserved on disk.

Can I use design tokens to enforce design system consistency across multiple starter archetypes?

Yes, design tokens are swept and integrated responsively to maintain design system consistency. The site build process supports multiple starter archetypes and applies the appropriate routing, page structure, and content model while honoring archetype constraints.

Does this site build process wire up a headless CMS or handle deployment?

No, this site build process is CMS-agnostic and does not wire CMS, run QA, or handle deployment. It focuses strictly on generating code and on-disk content artifacts, leaving external integrations and deployment to other pipeline stages.

What is the best way to apply local SEO defaults and page structure to a scaffold?

The best way to apply local SEO defaults is by consuming the site manifest and brief data to generate routes, sections, and SEO defaults for each page. This ensures the starter-specific routing and content model are correctly applied during the site assembly.

When should I preserve seed TODOs instead of upgrading to production copy?

Seed TODOs should be preserved when the contentSource configuration does not allow AI drafting. The build process respects this constraint by keeping placeholder content intact rather than upgrading it to production copy automatically.