docs: agents

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
+```markdown
-{
+---
-  "agent": {
+description: Writes and maintains project documentation
-    "docs-writer": {
+tools:
-      "description": "Writes and maintains project documentation",
+  bash: false
-      "prompt": "You are a technical writer. Create clear, comprehensive documentation.",
+---
-      "tools": {
+
-        "bash": false
+You are a technical writer. Create clear, comprehensive documentation.
-      }
-    }
-  }
-}
 ```
 
 ### Security Auditor
 
-```json
+```markdown
-{
+---
-  "agent": {
+description: Performs security audits and identifies vulnerabilities
-    "security-auditor": {
+tools:
-      "description": "Performs security audits and identifies vulnerabilities",
+  write: false
-      "prompt": "You are a security expert. Focus on identifying potential security issues.",
+  edit: false
-      "tools": {
+---
-        "write": false,
+
-        "edit": false
+You are a security expert. Focus on identifying potential security issues.
-      }
-    }
-  }
-}
 ```