Kickstart

Build a complete first-draft site from a single user prompt. This is the "magic moment" — user writes one sentence, watches their site come alive in real-time via live reload.

Input

The user's description of what they want:

$ARGUMENTS

If no arguments, ask: "What are you building? One sentence is enough."

Procedure

Step 1: Gather Context

Call these MCP tools in parallel:

• sitemd_site_context

  with contentType "page" and the user's description as topic
• Glob

  pages/**/*.md

  to see current state
• Read

  settings/groups.md

  for group structure

Step 2: Plan the Site

Based on the user's description, plan 3-6 pages:

• Home page (always)
• 2-4 content pages based on what they're building
• About page (if relevant)

Plan the navigation (header items) and any groups (docs sidebar, blog, etc.).

Present the plan briefly: "I'll create: Home, [pages...]. Here we go." — then proceed immediately without waiting for confirmation. This is a first draft, not a contract.

Step 3: Update Settings

Update these settings files directly (read each first, then edit the frontmatter):

1. settings/meta.md

   — site title, brand name, description based on user's description

2. settings/header.md

   — navigation items matching planned pages

3. settings/footer.md

   — brand name, relevant links

4. settings/groups.md

   — add groups if the site needs them (docs sidebar, blog, etc.)

Step 4: Create Pages

For each planned page, call

sitemd_pages_create

:

• Write real content (not placeholder) using the user's description as context
• Use rich components from the syntax reference:

  • button:

    for CTAs and navigation

  • card:

    blocks for feature grids, services, or options

  • gallery:

    or

    image-row:

    for visual content

  • embed:

    for video/audio

  • modal:

    for supplementary content

  • [text]{tooltip}

    for inline definitions
• Follow voice rules: second person, present tense, no hedging, lead with reader value
• Proper frontmatter: title, description (<160 chars), slug (

  /

  for home page), sidebarGroupShown, groupMember

Step 5: Validate

Call

sitemd_content_validate

on each created page. Fix any failures.

Step 6: Report

• List what was created (pages, settings updates)
• Remind user the dev server auto-rebuilds — their site is already live
• Suggest next steps: "Edit any page directly, use /write to add more content, or browse the demo at :4848 for component inspiration"

Rules

• No permission required — Execute immediately
• Speed over perfection — This is a first draft. Real content, but don't agonize over every word
• Use the user's words — Mirror their language and framing in the content
• 3-6 pages max — Keep the first draft focused. User can add more later
• Always use components — Cards, buttons, embeds make the site feel real, not a text dump
• Real content only — No placeholder text, no lorem ipsum, no "coming soon"
• Delete the default home page first — The scratch template ships with a generic welcome page. Remove it before creating the real home page