noopolis · apresmoi · Sep 13, 2026 · Sep 13, 2026
diff --git a/website/astro.config.mjs b/website/astro.config.mjs
@@ -9,7 +9,7 @@ export default defineConfig({
     sitemap(),
     starlight({
       title: 'Spawnfile',
-      description: 'A fully open-source spec and compiler for autonomous agents and teams.',
+      description: 'Define autonomous AI agents and multi-agent teams once, then compile portable Spawnfile manifests into runtime-native configuration.',
       components: {
         ThemeSelect: './src/components/EmptyThemeSelect.astro',
         SiteTitle: './src/components/SiteTitle.astro',

diff --git a/website/src/content/docs/concepts.md b/website/src/content/docs/concepts.md
@@ -1,6 +1,6 @@
 ---
 title: Core Concepts
-description: The key ideas behind Spawnfile.
+description: Understand Spawnfile manifests, identity documents, runtime adapters, compilation, teams, skills, MCP servers, and communication surfaces.
 ---
 
 ## Source Project

diff --git a/website/src/content/docs/guides/compiling.md b/website/src/content/docs/guides/compiling.md
@@ -1,6 +1,6 @@
 ---
 title: Compiling
-description: How the Spawnfile compile pipeline works, from manifest loading to adapter output, including the output layout and compile report.
+description: Compile AI agent manifests into runtime-native configuration for OpenClaw, PicoClaw, and Daimon with the Spawnfile CLI.
 ---
 
 The `spawnfile compile` command takes a Spawnfile project and produces runtime-specific output files plus a machine-readable compile report. This guide explains the pipeline, output layout, and report format.

diff --git a/website/src/content/docs/guides/skills-and-mcp.md b/website/src/content/docs/guides/skills-and-mcp.md
@@ -1,6 +1,6 @@
 ---
 title: Skills and MCP
-description: How to define skills with SKILL.md, declare MCP servers, and connect skills to MCP dependencies using requires.mcp.
+description: Add SKILL.md skills and MCP servers to AI agent configurations, declare dependencies, and compile them for supported runtimes.
 ---
 
 Skills and MCP servers are the two mechanisms Spawnfile provides for giving agents capabilities beyond conversation. Skills define what an agent can do in natural language. MCP servers provide the tool infrastructure that backs those skills.

diff --git a/website/src/content/docs/guides/teams.md b/website/src/content/docs/guides/teams.md
@@ -1,6 +1,6 @@
 ---
 title: Teams
-description: How to define team manifests with members, representatives, team networks, and context artifacts.
+description: Configure multi-agent teams with portable manifests, members, representatives, shared context, communication networks, and runtime adapters.
 ---
 
 A Spawnfile team is an organizational structure that groups multiple first-class agents. It defines who is in the team, what they share, how representatives are selected, and which team networks and context artifacts the compiler emits.

diff --git a/website/src/content/docs/guides/writing-a-spawnfile.md b/website/src/content/docs/guides/writing-a-spawnfile.md
@@ -1,6 +1,6 @@
 ---
 title: Writing a Spawnfile
-description: Guide to the common Spawnfile manifest fields for agents and teams, with examples for the main portable sections.
+description: Write YAML manifests for autonomous AI agents and teams, including runtimes, models, identity documents, skills, MCP servers, and secrets.
 ---
 
 A Spawnfile manifest is a YAML file named exactly `Spawnfile` (no extension) at the root of your agent or team project directory. It must be valid YAML 1.2 and UTF-8 encoded with no BOM.

diff --git a/website/src/content/docs/introduction.md b/website/src/content/docs/introduction.md
@@ -1,6 +1,6 @@
 ---
 title: Introduction
-description: What Spawnfile is and why it exists.
+description: Learn how Spawnfile defines autonomous agents once and compiles their identity, tools, and configuration for supported runtimes.
 ---
 
 Spawnfile is a spec and compiler for **autonomous agent runtimes** -- systems that host agents as long-lived services with markdown workspace identity.

diff --git a/website/src/content/docs/quickstart.md b/website/src/content/docs/quickstart.md
@@ -1,6 +1,6 @@
 ---
 title: Quickstart
-description: Install Spawnfile and compile your first agent in 5 minutes.
+description: Install the Spawnfile CLI, create an AI agent manifest, validate it, and compile runtime-native configuration for a supported runtime.
 ---
 
 ## Install

diff --git a/website/src/pages/index.astro b/website/src/pages/index.astro
@@ -10,17 +10,17 @@
 <!-- Google Analytics -->
 <script async src="https://www.googletagmanager.com/gtag/js?id=G-8ZM3Y7MCD5"></script>
 <script>window.dataLayer=window.dataLayer||[];function gtag(){dataLayer.push(arguments);}gtag('js',new Date());gtag('config','G-8ZM3Y7MCD5');</script>
-<title>Spawnfile — Dockerfile for agents</title>
-<meta name="description" content="A fully open-source spec and compiler for autonomous agents and teams. Write your agent once, compile for any runtime.">
+<title>AI Agent Configuration &amp; Runtime Compiler | Spawnfile</title>
+<meta name="description" content="Define autonomous AI agents and multi-agent teams once, then compile portable Spawnfile manifests for OpenClaw, PicoClaw, and Daimon runtimes.">
 <link rel="canonical" href="https://spawnfile.com/">
 <meta name="theme-color" content="#0b0b0b">
 <meta name="author" content="Noopolis">
 
 <!-- Open Graph -->
 <meta property="og:type" content="website">
 <meta property="og:site_name" content="Spawnfile">
-<meta property="og:title" content="Spawnfile — Dockerfile for agents">
-<meta property="og:description" content="A fully open-source spec and compiler for autonomous agents and teams. Write your agent once, compile for any runtime.">
+<meta property="og:title" content="AI Agent Configuration &amp; Runtime Compiler | Spawnfile">
+<meta property="og:description" content="Define autonomous AI agents and multi-agent teams once, then compile portable Spawnfile manifests for OpenClaw, PicoClaw, and Daimon runtimes.">
 <meta property="og:url" content="https://spawnfile.com/">
 <meta property="og:image" content="https://spawnfile.com/og.png">
 <meta property="og:image:width" content="1200">
@@ -30,8 +30,8 @@
 
 <!-- Twitter -->
 <meta name="twitter:card" content="summary_large_image">
-<meta name="twitter:title" content="Spawnfile — Dockerfile for agents">
-<meta name="twitter:description" content="A fully open-source spec and compiler for autonomous agents and teams. Write your agent once, compile for any runtime.">
+<meta name="twitter:title" content="AI Agent Configuration &amp; Runtime Compiler | Spawnfile">
+<meta name="twitter:description" content="Define autonomous AI agents and multi-agent teams once, then compile portable manifests for OpenClaw, PicoClaw, and Daimon runtimes.">
 <meta name="twitter:image" content="https://spawnfile.com/og.png">
 
 <!-- Favicons -->
@@ -47,13 +47,13 @@
     {
       "@type": "WebSite",
       "name": "Spawnfile",
-      "url": "https://spawnfile.com",
-      "description": "A fully open-source spec and compiler for autonomous agents and teams."
+      "url": "https://spawnfile.com/",
+      "description": "A portable configuration format and compiler for autonomous AI agents and multi-agent teams."
     },
     {
       "@type": "SoftwareSourceCode",
       "name": "Spawnfile",
-      "description": "A spec and compiler for autonomous agent runtimes. Write your agent once, compile for any runtime.",
+      "description": "A runtime-independent source format for autonomous agents and teams, with a compiler that emits native configuration for each supported runtime.",
       "url": "https://github.com/noopolis/spawnfile",
       "codeRepository": "https://github.com/noopolis/spawnfile",
       "license": "https://opensource.org/licenses/MIT",