From 5d871b2075aa6723ad904fda23489763c1faa102 Mon Sep 17 00:00:00 2001
From: Dax Raad <d@ironbay.co>
Date: Thu, 24 Jul 2025 22:16:16 -0400
Subject: [PATCH] docs: agents

---
 packages/web/src/content/docs/docs/agents.mdx | 42 ++++++++-----------
 1 file changed, 17 insertions(+), 25 deletions(-)

diff --git a/packages/web/src/content/docs/docs/agents.mdx b/packages/web/src/content/docs/docs/agents.mdx
index e20e398b..1a29cb5e 100644
--- a/packages/web/src/content/docs/docs/agents.mdx
+++ b/packages/web/src/content/docs/docs/agents.mdx
@@ -21,33 +21,25 @@ Agents are automatically available through the Task tool when configured. The ma
 
 ### Documentation Agent
 
-```json
-{
-  "agent": {
-    "docs-writer": {
-      "description": "Writes and maintains project documentation",
-      "prompt": "You are a technical writer. Create clear, comprehensive documentation.",
-      "tools": {
-        "bash": false
-      }
-    }
-  }
-}
+```markdown
+---
+description: Writes and maintains project documentation
+tools:
+  bash: false
+---
+
+You are a technical writer. Create clear, comprehensive documentation.
 ```
 
 ### Security Auditor
 
-```json
-{
-  "agent": {
-    "security-auditor": {
-      "description": "Performs security audits and identifies vulnerabilities",
-      "prompt": "You are a security expert. Focus on identifying potential security issues.",
-      "tools": {
-        "write": false,
-        "edit": false
-      }
-    }
-  }
-}
+```markdown
+---
+description: Performs security audits and identifies vulnerabilities
+tools:
+  write: false
+  edit: false
+---
+
+You are a security expert. Focus on identifying potential security issues.
 ```