diff --git a/docs/channels/irc.md b/docs/channels/irc.md
index 33c2e47fe29..8475c6a4454 100644
--- a/docs/channels/irc.md
+++ b/docs/channels/irc.md
@@ -1,6 +1,5 @@
 ---
 title: IRC
-description: Connect OpenClaw to IRC channels and direct messages.
 summary: "IRC plugin setup, access controls, and troubleshooting"
 read_when:
   - You want to connect OpenClaw to IRC channels or DMs
diff --git a/docs/ci.md b/docs/ci.md
index e8710b87cb1..36e5fba0d8c 100644
--- a/docs/ci.md
+++ b/docs/ci.md
@@ -1,6 +1,5 @@
 ---
 title: CI Pipeline
-description: How the OpenClaw CI pipeline works
 summary: "CI job graph, scope gates, and local command equivalents"
 read_when:
   - You need to understand why a CI job did or did not run
diff --git a/docs/gateway/configuration-reference.md b/docs/gateway/configuration-reference.md
index 9e3b14c011c..57756608a35 100644
--- a/docs/gateway/configuration-reference.md
+++ b/docs/gateway/configuration-reference.md
@@ -1,6 +1,5 @@
 ---
 title: "Configuration Reference"
-description: "Complete field-by-field reference for ~/.openclaw/openclaw.json"
 summary: "Complete reference for every OpenClaw config key, defaults, and channel settings"
 read_when:
   - You need exact field-level config semantics or defaults
diff --git a/docs/gateway/trusted-proxy-auth.md b/docs/gateway/trusted-proxy-auth.md
index 7144452b2e6..cff00bb6720 100644
--- a/docs/gateway/trusted-proxy-auth.md
+++ b/docs/gateway/trusted-proxy-auth.md
@@ -1,4 +1,5 @@
 ---
+title: "Trusted Proxy Auth"
 summary: "Delegate gateway authentication to a trusted reverse proxy (Pomerium, Caddy, nginx + OAuth)"
 read_when:
   - Running OpenClaw behind an identity-aware proxy
diff --git a/docs/install/fly.md b/docs/install/fly.md
index aacfa484670..0a5c9b22338 100644
--- a/docs/install/fly.md
+++ b/docs/install/fly.md
@@ -1,6 +1,5 @@
 ---
 title: Fly.io
-description: Deploy OpenClaw on Fly.io
 summary: "Step-by-step Fly.io deployment for OpenClaw with persistent storage and HTTPS"
 read_when:
   - Deploying OpenClaw on Fly.io
diff --git a/docs/start/showcase.md b/docs/start/showcase.md
index 6ebcbdb2bcb..9b382a0e2f7 100644
--- a/docs/start/showcase.md
+++ b/docs/start/showcase.md
@@ -1,6 +1,5 @@
 ---
 title: "Showcase"
-description: "Real-world OpenClaw projects from the community"
 summary: "Community-built projects and integrations powered by OpenClaw"
 read_when:
   - Looking for real OpenClaw usage examples
diff --git a/docs/tools/diffs.md b/docs/tools/diffs.md
index 3e0289dd05d..f502fdbccef 100644
--- a/docs/tools/diffs.md
+++ b/docs/tools/diffs.md
@@ -1,7 +1,6 @@
 ---
 title: "Diffs"
 summary: "Read-only diff viewer and file renderer for agents (optional plugin tool)"
-description: "Use the optional Diffs plugin to render before and after text or unified patches as a gateway-hosted diff view, a file (PNG or PDF), or both."
 read_when:
   - You want agents to show code or markdown edits as diffs
   - You want a canvas-ready viewer URL or a rendered diff file
diff --git a/docs/tools/lobster.md b/docs/tools/lobster.md
index 5c8a47e4d62..6e502c09c19 100644
--- a/docs/tools/lobster.md
+++ b/docs/tools/lobster.md
@@ -1,7 +1,6 @@
 ---
 title: Lobster
 summary: "Typed workflow runtime for OpenClaw with resumable approval gates."
-description: Typed workflow runtime for OpenClaw — composable pipelines with approval gates.
 read_when:
   - You want deterministic multi-step workflows with explicit approvals
   - You need to resume a workflow without re-running earlier steps
diff --git a/docs/tools/loop-detection.md b/docs/tools/loop-detection.md
index 56d843f1276..d0071cf5064 100644
--- a/docs/tools/loop-detection.md
+++ b/docs/tools/loop-detection.md
@@ -1,6 +1,5 @@
 ---
 title: "Tool-loop detection"
-description: "Configure optional guardrails for preventing repetitive or stalled tool-call loops"
 summary: "How to enable and tune guardrails that detect repetitive tool-call loops"
 read_when:
   - A user reports agents getting stuck repeating tool calls