Add 'AI Tools' section to nav with Overview, Agent Skills, Docs MCP (#22964)

rmloveland · web-flow · commit dee2778da7e8 · 2026-03-05T21:25:48.000Z
* Add 'AI Tools' section to nav with Overview, Agent Skills, Docs MCP Fixes DOC-16269
diff --git a/src/current/Gemfile b/src/current/Gemfile
@@ -19,6 +19,7 @@ gem "csv"
 gem "logger"
 gem "base64"
 gem "bigdecimal"
+gem "ostruct"
 group :jekyll_plugins do
     gem "jekyll-include-cache"
     gem 'jekyll-algolia', "~> 1.0", path: "./jekyll-algolia-dev"
diff --git a/src/current/Gemfile.lock b/src/current/Gemfile.lock
@@ -123,6 +123,7 @@ GEM
       racc (~> 1.4)
     nokogiri (1.19.0-x86_64-linux-musl)
       racc (~> 1.4)
+    ostruct (0.6.3)
     pathutil (0.16.2)
       forwardable-extended (~> 2.6)
     progressbar (1.13.0)
@@ -171,6 +172,7 @@ DEPENDENCIES
   jekyll-sass-converter (~> 2.0)
   liquid-c (~> 4.0.0)
   logger
+  ostruct
   redcarpet (~> 3.6)
   rss
   webrick
@@ -230,6 +232,7 @@ CHECKSUMS
   nokogiri (1.19.0-x86_64-darwin) sha256=1dad56220b603a8edb9750cd95798bffa2b8dd9dd9aa47f664009ee5b43e3067
   nokogiri (1.19.0-x86_64-linux-gnu) sha256=f482b95c713d60031d48c44ce14562f8d2ce31e3a9e8dd0ccb131e9e5a68b58c
   nokogiri (1.19.0-x86_64-linux-musl) sha256=1c4ca6b381622420073ce6043443af1d321e8ed93cc18b08e2666e5bd02ffae4
+  ostruct (0.6.3) sha256=95a2ed4a4bd1d190784e666b47b2d3f078e4a9efda2fccf18f84ddc6538ed912
   pathutil (0.16.2) sha256=e43b74365631cab4f6d5e4228f812927efc9cb2c71e62976edcb252ee948d589
   progressbar (1.13.0) sha256=18c921d1c527dbe7eba3c5a07a1e3bcdd5e42fc18276f5711187a7489448be78
   public_suffix (7.0.2) sha256=9114090c8e4e7135c1fd0e7acfea33afaab38101884320c65aaa0ffb8e26a857
diff --git a/src/current/_includes/sidebar-data-v24.1.json b/src/current/_includes/sidebar-data-v24.1.json
@@ -7,6 +7,7 @@
     ]
   },
   {% include_cached v24.1/sidebar-data/get-started.json %},
+  {% include_cached v24.1/sidebar-data/ai-tools.json %},
   {% include_cached v24.1/sidebar-data/releases.json %},
   {% include_cached v24.1/sidebar-data/feature-overview.json %},
   {% include_cached v24.1/sidebar-data/connect-to-cockroachdb.json %},
diff --git a/src/current/_includes/sidebar-data-v24.3.json b/src/current/_includes/sidebar-data-v24.3.json
@@ -7,6 +7,7 @@
     ]
   },
   {% include_cached v24.3/sidebar-data/get-started.json %},
+  {% include_cached v24.3/sidebar-data/ai-tools.json %},
   {% include_cached v24.3/sidebar-data/releases.json %},
   {% include_cached v24.3/sidebar-data/feature-overview.json %},
   {% include_cached v24.3/sidebar-data/resilience.json %},
diff --git a/src/current/_includes/sidebar-data-v25.2.json b/src/current/_includes/sidebar-data-v25.2.json
@@ -7,6 +7,7 @@
     ]
   },
   {% include_cached v25.2/sidebar-data/get-started.json %},
+  {% include_cached v25.2/sidebar-data/ai-tools.json %},
   {% include_cached v25.2/sidebar-data/releases.json %},
   {% include_cached v25.2/sidebar-data/feature-overview.json %},
   {% include_cached v25.2/sidebar-data/resilience.json %},
diff --git a/src/current/_includes/sidebar-data-v25.4.json b/src/current/_includes/sidebar-data-v25.4.json
@@ -7,6 +7,7 @@
     ]
   },
   {% include_cached v25.4/sidebar-data/get-started.json %},
+  {% include_cached v25.4/sidebar-data/ai-tools.json %},
   {% include_cached v25.4/sidebar-data/releases.json %},
   {% include_cached v25.4/sidebar-data/feature-overview.json %},
   {% include_cached v25.4/sidebar-data/resilience.json %},
diff --git a/src/current/_includes/sidebar-data-v26.1.json b/src/current/_includes/sidebar-data-v26.1.json
@@ -7,6 +7,7 @@
     ]
   },
   {% include_cached v26.1/sidebar-data/get-started.json %},
+  {% include_cached v26.1/sidebar-data/ai-tools.json %},
   {% include_cached v26.1/sidebar-data/releases.json %},
   {% include_cached v26.1/sidebar-data/feature-overview.json %},
   {% include_cached v26.1/sidebar-data/resilience.json %},
diff --git a/src/current/_includes/v24.1/sidebar-data/ai-tools.json b/src/current/_includes/v24.1/sidebar-data/ai-tools.json
@@ -0,0 +1,24 @@
+{
+  "title": "AI Tools",
+  "is_top_level": true,
+  "items": [
+    {
+      "title": "Overview",
+      "urls": [
+        "/${VERSION}/ai-tools-overview.html"
+      ]
+    },
+    {
+      "title": "Agent Skills for CockroachDB",
+      "urls": [
+        "/${VERSION}/agent-skills.html"
+      ]
+    },
+    {
+      "title": "Docs MCP Server",
+      "urls": [
+        "/${VERSION}/docs-mcp-integration.html"
+      ]
+    }
+  ]
+}
diff --git a/src/current/_includes/v24.3/sidebar-data/ai-tools.json b/src/current/_includes/v24.3/sidebar-data/ai-tools.json
@@ -0,0 +1,24 @@
+{
+  "title": "AI Tools",
+  "is_top_level": true,
+  "items": [
+    {
+      "title": "Overview",
+      "urls": [
+        "/${VERSION}/ai-tools-overview.html"
+      ]
+    },
+    {
+      "title": "Agent Skills for CockroachDB",
+      "urls": [
+        "/${VERSION}/agent-skills.html"
+      ]
+    },
+    {
+      "title": "Docs MCP Server",
+      "urls": [
+        "/${VERSION}/docs-mcp-integration.html"
+      ]
+    }
+  ]
+}
diff --git a/src/current/_includes/v25.2/sidebar-data/ai-tools.json b/src/current/_includes/v25.2/sidebar-data/ai-tools.json
@@ -0,0 +1,24 @@
+{
+  "title": "AI Tools",
+  "is_top_level": true,
+  "items": [
+    {
+      "title": "Overview",
+      "urls": [
+        "/${VERSION}/ai-tools-overview.html"
+      ]
+    },
+    {
+      "title": "Agent Skills for CockroachDB",
+      "urls": [
+        "/${VERSION}/agent-skills.html"
+      ]
+    },
+    {
+      "title": "Docs MCP Server",
+      "urls": [
+        "/${VERSION}/docs-mcp-integration.html"
+      ]
+    }
+  ]
+}
diff --git a/src/current/_includes/v25.4/sidebar-data/ai-tools.json b/src/current/_includes/v25.4/sidebar-data/ai-tools.json
@@ -0,0 +1,24 @@
+{
+  "title": "AI Tools",
+  "is_top_level": true,
+  "items": [
+    {
+      "title": "Overview",
+      "urls": [
+        "/${VERSION}/ai-tools-overview.html"
+      ]
+    },
+    {
+      "title": "Agent Skills for CockroachDB",
+      "urls": [
+        "/${VERSION}/agent-skills.html"
+      ]
+    },
+    {
+      "title": "Docs MCP Server",
+      "urls": [
+        "/${VERSION}/docs-mcp-integration.html"
+      ]
+    }
+  ]
+}
diff --git a/src/current/_includes/v26.1/sidebar-data/ai-tools.json b/src/current/_includes/v26.1/sidebar-data/ai-tools.json
@@ -0,0 +1,24 @@
+{
+  "title": "AI Tools",
+  "is_top_level": true,
+  "items": [
+    {
+      "title": "Overview",
+      "urls": [
+        "/${VERSION}/ai-tools-overview.html"
+      ]
+    },
+    {
+      "title": "Agent Skills for CockroachDB",
+      "urls": [
+        "/${VERSION}/agent-skills.html"
+      ]
+    },
+    {
+      "title": "Docs MCP Server",
+      "urls": [
+        "/${VERSION}/docs-mcp-integration.html"
+      ]
+    }
+  ]
+}
diff --git a/src/current/v24.1/agent-skills.md b/src/current/v24.1/agent-skills.md
@@ -0,0 +1,39 @@
+---
+title: Agent Skills for CockroachDB
+summary: Learn about the CockroachDB Agent Skills Git repository and how to use or contribute to it
+toc: true
+docs_area: ai_tools
+---
+
+Cockroach Labs provides a public [cockroachdb-skills](https://github.com/cockroachlabs/cockroachdb-skills) repository with a curated collection of Agent Skills for CockroachDB. These skills encode operational expertise so that AI agents, automation systems, and developer tools can perform production-grade CockroachDB operations.
+
+## What is a CockroachDB Agent Skill?
+
+A CockroachDB Agent Skill:
+
+- Encodes operational expertise for a specific task or workflow.
+- Follows the [Agent Skills Specification](https://agentskills.io/specification).
+- Is machine-executable, with clear inputs, outputs, and safety guardrails.
+- Links to authoritative CockroachDB documentation rather than duplicating it.
+
+Skills live under [the repository's `skills/` directory](https://github.com/cockroachlabs/cockroachdb-skills/tree/main/skills).
+
+## Skill domains
+
+Skills are organized into the following operational domains:
+
+- Onboarding and migrations
+- Application development
+- Performance and scaling
+- Operations and lifecycle
+- Resilience and Disaster Recovery (DR)
+- Observability and Diagnostics
+- Security and Governance
+- Integrations and Ecosystem
+- Cost and usage management
+
+## See also
+
+- [AI Tools Overview]({% link {{ page.version.version }}/ai-tools-overview.md %})
+- [CockroachDB Docs MCP Server]({% link {{ page.version.version }}/docs-mcp-integration.md %})
+- [CockroachDB Skills repository](https://github.com/cockroachlabs/cockroachdb-skills)
diff --git a/src/current/v24.1/ai-tools-overview.md b/src/current/v24.1/ai-tools-overview.md
@@ -0,0 +1,19 @@
+---
+title: AI Tools Overview
+summary: A quick guide to AI tools and integrations for working with CockroachDB
+toc: false
+docs_area: ai_tools
+---
+
+The pages in this section have information about AI tools and integrations that help you enhance your use of CockroachDB with AI assistants, including agentic automation systems.
+
+## In this section
+
+- [Agent Skills for CockroachDB]({% link {{ page.version.version }}/agent-skills.md %}): A public Git repository of Agent Skills for CockroachDB. These skills encode operational expertise so that AI agents, automation systems, and developer tools can perform production-grade CockroachDB operations.
+- [CockroachDB Docs MCP Server]({% link {{ page.version.version }}/docs-mcp-integration.md %}): Connect AI assistants to CockroachDB documentation using the Model Context Protocol (MCP).
+
+## See also
+
+- [How CockroachDB's AI Assistance Boosts Developer Productivity](https://www.cockroachlabs.com/blog/cockroachdb-ai-assistance-for-developers/)
+- [Tutorial: Augment your AI use case with RAG on CockroachDB](https://www.cockroachlabs.com/blog/tutorial-rag-with-cockroachdb/)
+- [Real-Time Indexing for Billions of Vectors: How we built fast, fresh vector indexing at scale in CockroachDB](https://www.cockroachlabs.com/blog/cspann-real-time-indexing-billions-vectors/)
diff --git a/src/current/v24.3/agent-skills.md b/src/current/v24.3/agent-skills.md
@@ -0,0 +1,39 @@
+---
+title: Agent Skills for CockroachDB
+summary: Learn about the CockroachDB Agent Skills Git repository and how to use or contribute to it
+toc: true
+docs_area: ai_tools
+---
+
+Cockroach Labs provides a public [cockroachdb-skills](https://github.com/cockroachlabs/cockroachdb-skills) repository with a curated collection of Agent Skills for CockroachDB. These skills encode operational expertise so that AI agents, automation systems, and developer tools can perform production-grade CockroachDB operations.
+
+## What is a CockroachDB Agent Skill?
+
+A CockroachDB Agent Skill:
+
+- Encodes operational expertise for a specific task or workflow.
+- Follows the [Agent Skills Specification](https://agentskills.io/specification).
+- Is machine-executable, with clear inputs, outputs, and safety guardrails.
+- Links to authoritative CockroachDB documentation rather than duplicating it.
+
+Skills live under [the repository's `skills/` directory](https://github.com/cockroachlabs/cockroachdb-skills/tree/main/skills).
+
+## Skill domains
+
+Skills are organized into the following operational domains:
+
+- Onboarding and migrations
+- Application development
+- Performance and scaling
+- Operations and lifecycle
+- Resilience and Disaster Recovery (DR)
+- Observability and Diagnostics
+- Security and Governance
+- Integrations and Ecosystem
+- Cost and usage management
+
+## See also
+
+- [AI Tools Overview]({% link {{ page.version.version }}/ai-tools-overview.md %})
+- [CockroachDB Docs MCP Server]({% link {{ page.version.version }}/docs-mcp-integration.md %})
+- [CockroachDB Skills repository](https://github.com/cockroachlabs/cockroachdb-skills)
diff --git a/src/current/v24.3/ai-tools-overview.md b/src/current/v24.3/ai-tools-overview.md
@@ -0,0 +1,19 @@
+---
+title: AI Tools Overview
+summary: A quick guide to AI tools and integrations for working with CockroachDB
+toc: false
+docs_area: ai_tools
+---
+
+The pages in this section have information about AI tools and integrations that help you enhance your use of CockroachDB with AI assistants, including agentic automation systems.
+
+## In this section
+
+- [Agent Skills for CockroachDB]({% link {{ page.version.version }}/agent-skills.md %}): A public Git repository of Agent Skills for CockroachDB. These skills encode operational expertise so that AI agents, automation systems, and developer tools can perform production-grade CockroachDB operations.
+- [CockroachDB Docs MCP Server]({% link {{ page.version.version }}/docs-mcp-integration.md %}): Connect AI assistants to CockroachDB documentation using the Model Context Protocol (MCP).
+
+## See also
+
+- [How CockroachDB's AI Assistance Boosts Developer Productivity](https://www.cockroachlabs.com/blog/cockroachdb-ai-assistance-for-developers/)
+- [Tutorial: Augment your AI use case with RAG on CockroachDB](https://www.cockroachlabs.com/blog/tutorial-rag-with-cockroachdb/)
+- [Real-Time Indexing for Billions of Vectors: How we built fast, fresh vector indexing at scale in CockroachDB](https://www.cockroachlabs.com/blog/cspann-real-time-indexing-billions-vectors/)
diff --git a/src/current/v25.2/agent-skills.md b/src/current/v25.2/agent-skills.md
@@ -0,0 +1,39 @@
+---
+title: Agent Skills for CockroachDB
+summary: Learn about the CockroachDB Agent Skills Git repository and how to use or contribute to it
+toc: true
+docs_area: ai_tools
+---
+
+Cockroach Labs provides a public [cockroachdb-skills](https://github.com/cockroachlabs/cockroachdb-skills) repository with a curated collection of Agent Skills for CockroachDB. These skills encode operational expertise so that AI agents, automation systems, and developer tools can perform production-grade CockroachDB operations.
+
+## What is a CockroachDB Agent Skill?
+
+A CockroachDB Agent Skill:
+
+- Encodes operational expertise for a specific task or workflow.
+- Follows the [Agent Skills Specification](https://agentskills.io/specification).
+- Is machine-executable, with clear inputs, outputs, and safety guardrails.
+- Links to authoritative CockroachDB documentation rather than duplicating it.
+
+Skills live under [the repository's `skills/` directory](https://github.com/cockroachlabs/cockroachdb-skills/tree/main/skills).
+
+## Skill domains
+
+Skills are organized into the following operational domains:
+
+- Onboarding and migrations
+- Application development
+- Performance and scaling
+- Operations and lifecycle
+- Resilience and Disaster Recovery (DR)
+- Observability and Diagnostics
+- Security and Governance
+- Integrations and Ecosystem
+- Cost and usage management
+
+## See also
+
+- [AI Tools Overview]({% link {{ page.version.version }}/ai-tools-overview.md %})
+- [CockroachDB Docs MCP Server]({% link {{ page.version.version }}/docs-mcp-integration.md %})
+- [CockroachDB Skills repository](https://github.com/cockroachlabs/cockroachdb-skills)
diff --git a/src/current/v25.2/ai-tools-overview.md b/src/current/v25.2/ai-tools-overview.md
@@ -0,0 +1,20 @@
+---
+title: AI Tools Overview
+summary: A quick guide to AI tools and integrations for working with CockroachDB
+toc: false
+docs_area: ai_tools
+---
+
+The pages in this section have information about AI tools and integrations that help you enhance your use of CockroachDB with AI assistants, including agentic automation systems.
+
+## In this section
+
+- [Agent Skills for CockroachDB]({% link {{ page.version.version }}/agent-skills.md %}): A public Git repository of Agent Skills for CockroachDB. These skills encode operational expertise so that AI agents, automation systems, and developer tools can perform production-grade CockroachDB operations.
+- [CockroachDB Docs MCP Server]({% link {{ page.version.version }}/docs-mcp-integration.md %}): Connect AI assistants to CockroachDB documentation using the Model Context Protocol (MCP).
+
+## See also
+
+- [How CockroachDB's AI Assistance Boosts Developer Productivity](https://www.cockroachlabs.com/blog/cockroachdb-ai-assistance-for-developers/)
+- [Tutorial: Augment your AI use case with RAG on CockroachDB](https://www.cockroachlabs.com/blog/tutorial-rag-with-cockroachdb/)
+- [Real-Time Indexing for Billions of Vectors: How we built fast, fresh vector indexing at scale in CockroachDB](https://www.cockroachlabs.com/blog/cspann-real-time-indexing-billions-vectors/)
+- [Vector indexes]({% link {{ page.version.version }}/vector-indexes.md %})
diff --git a/src/current/v25.4/agent-skills.md b/src/current/v25.4/agent-skills.md
diff --git a/src/current/v25.4/ai-tools-overview.md b/src/current/v25.4/ai-tools-overview.md
diff --git a/src/current/v26.1/agent-skills.md b/src/current/v26.1/agent-skills.md
diff --git a/src/current/v26.1/ai-tools-overview.md b/src/current/v26.1/ai-tools-overview.md

Original file line number	Diff line number	Diff line change
`@@ -7,6 +7,7 @@`
`7`	`7`	`]`
`8`	`8`	`},`
`9`	`9`	`{% include_cached v24.1/sidebar-data/get-started.json %},`
	`10`	`+ {% include_cached v24.1/sidebar-data/ai-tools.json %},`
`10`	`11`	`{% include_cached v24.1/sidebar-data/releases.json %},`
`11`	`12`	`{% include_cached v24.1/sidebar-data/feature-overview.json %},`
`12`	`13`	`{% include_cached v24.1/sidebar-data/connect-to-cockroachdb.json %},`
Original file line number	Diff line number	Diff line change
`@@ -7,6 +7,7 @@`
`7`	`7`	`]`
`8`	`8`	`},`
`9`	`9`	`{% include_cached v24.3/sidebar-data/get-started.json %},`
	`10`	`+ {% include_cached v24.3/sidebar-data/ai-tools.json %},`
`10`	`11`	`{% include_cached v24.3/sidebar-data/releases.json %},`
`11`	`12`	`{% include_cached v24.3/sidebar-data/feature-overview.json %},`
`12`	`13`	`{% include_cached v24.3/sidebar-data/resilience.json %},`
Original file line number	Diff line number	Diff line change
`@@ -7,6 +7,7 @@`
`7`	`7`	`]`
`8`	`8`	`},`
`9`	`9`	`{% include_cached v25.2/sidebar-data/get-started.json %},`
	`10`	`+ {% include_cached v25.2/sidebar-data/ai-tools.json %},`
`10`	`11`	`{% include_cached v25.2/sidebar-data/releases.json %},`
`11`	`12`	`{% include_cached v25.2/sidebar-data/feature-overview.json %},`
`12`	`13`	`{% include_cached v25.2/sidebar-data/resilience.json %},`
Original file line number	Diff line number	Diff line change
`@@ -7,6 +7,7 @@`
`7`	`7`	`]`
`8`	`8`	`},`
`9`	`9`	`{% include_cached v25.4/sidebar-data/get-started.json %},`
	`10`	`+ {% include_cached v25.4/sidebar-data/ai-tools.json %},`
`10`	`11`	`{% include_cached v25.4/sidebar-data/releases.json %},`
`11`	`12`	`{% include_cached v25.4/sidebar-data/feature-overview.json %},`
`12`	`13`	`{% include_cached v25.4/sidebar-data/resilience.json %},`
Original file line number	Diff line number	Diff line change
`@@ -7,6 +7,7 @@`
`7`	`7`	`]`
`8`	`8`	`},`
`9`	`9`	`{% include_cached v26.1/sidebar-data/get-started.json %},`
	`10`	`+ {% include_cached v26.1/sidebar-data/ai-tools.json %},`
`10`	`11`	`{% include_cached v26.1/sidebar-data/releases.json %},`
`11`	`12`	`{% include_cached v26.1/sidebar-data/feature-overview.json %},`
`12`	`13`	`{% include_cached v26.1/sidebar-data/resilience.json %},`