1 files 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 e20e398b8..1a29cb5ef 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.
 ```