Validate yaml in doc

docs/configuration/agents/index.md

@@ -10,6 +10,7 @@ _Complete reference for defining agents in your YAML configuration._
 
 ## Full Schema
 
+<!-- yaml-lint:skip -->
 ```yaml
 agents:
   agent_name:

docs/configuration/models/index.md

@@ -10,6 +10,7 @@ _Complete reference for defining models with providers, parameters, and reasonin
 
 ## Full Schema
 
+<!-- yaml-lint:skip -->
 ```yaml
 models:
   model_name:

docs/configuration/tools/index.md

@@ -412,10 +412,11 @@ agents:
             cmd: task lint
       # Custom API tool
       - type: api
-        name: get_status
-        method: GET
-        endpoint: "https://api.example.com/status"
-        instruction: Check service health
+        api_config:
+          name: get_status
+          method: GET
+          endpoint: "https://api.example.com/status"
+          instruction: Check service health
       # Docker MCP tools
       - type: mcp
         ref: docker:github-official

docs/features/rag/index.md

@@ -22,7 +22,8 @@ RAG lets agents search through your documents to find relevant information befor
 ```yaml
 rag:
   my_docs:
-    description: "Technical documentation"
+    tool:
+      description: "Technical documentation"
     docs: [./documents, ./some-doc.md]
     strategies:
       - type: chunked-embeddings

docs/features/skills/index.md

@@ -36,6 +36,7 @@ agents:
 
 ## SKILL.md Format
 
+<!-- yaml-lint:skip -->
 ```yaml
 ---
 name: create-dockerfile