[WIP] feat (AI): Add new Sentry in AI section to docs

app/[[...path]]/page.tsx

@@ -9,6 +9,7 @@ import {ApiPage} from 'sentry-docs/components/apiPage';
 import {DocPage} from 'sentry-docs/components/docPage';
 import {Home} from 'sentry-docs/components/home';
 import {Include} from 'sentry-docs/components/include';
+import {LinkCard, LinkCardGrid} from 'sentry-docs/components/linkCard';
 import {PageLoadMetrics} from 'sentry-docs/components/pageLoadMetrics';
 import {PlatformContent} from 'sentry-docs/components/platformContent';
 import {
@@ -47,19 +48,23 @@ export async function generateStaticParams() {
 export const dynamicParams = false;
 export const dynamic = 'force-static';
 
-const mdxComponentsWithWrapper = mdxComponents(
-  {Include, PlatformContent},
-  ({children, frontMatter, nextPage, previousPage}) => (
-    <DocPage
-      frontMatter={frontMatter}
-      nextPage={nextPage}
-      previousPage={previousPage}
-      fullWidth={frontMatter.fullWidth}
-    >
-      {children}
-    </DocPage>
-  )
-);
+const mdxComponentsWithWrapper = {
+  ...mdxComponents(
+    {Include, PlatformContent},
+    ({children, frontMatter, nextPage, previousPage}) => (
+      <DocPage
+        frontMatter={frontMatter}
+        nextPage={nextPage}
+        previousPage={previousPage}
+        fullWidth={frontMatter.fullWidth}
+      >
+        {children}
+      </DocPage>
+    )
+  ),
+  LinkCard,
+  LinkCardGrid,
+};
 
 function MDXLayoutRenderer({mdxSource, ...rest}) {
   const MDXLayout = useMemo(() => getMDXComponent(mdxSource), [mdxSource]);

docs/ai/agent-skills.mdx

@@ -0,0 +1,136 @@
+---
+title: Agent Skills
+sidebar_order: 10
+description: "Teach your AI coding assistant how to set up and configure Sentry in your projects, and how to use Sentry's AI agents to debug and fix issues, even in your PRs."
+keywords:
+  - agent skills
+  - Claude Code
+  - Cursor
+  - GitHub Copilot
+  - OpenAI Codex
+  - AI coding assistant
+  - vibe coding
+  - AI setup
+  - Windsurf
+  - AmpCode
+  - OpenCode
+---
+
+Agent skills are instruction sets that teach AI coding assistants how to perform specific tasks. Sentry's official agent skills give your AI assistant the knowledge to set up and configure Sentry in your projects with no manual configuration required. Use [workflow skills](/ai/agent-skills/#workflow-skills) to debug and fix issues in your projects.
+
+<StepComponent>
+
+## Available Skills
+There are two types of official Sentry agent skills: 
+
+- **Setup skills** - Set up Sentry in your projects with no manual configuration required.
+- **Workflow skills** - Debug and fix issues in your projects.
+
+Check out the latest and full list of skills [here](https://skills.sh/getsentry/sentry-agent-skills).
+
+## Install
+
+Run this in your project (or from any directory for user-level install) to add Sentry agent skills. Omit `--skill` to add all skills from the repo.
+
+```bash
+npx skills add https://github.com/getsentry/sentry-agent-skills --skill sentry-fix-issues
+```
+
+To add all Sentry skills:
+
+```bash
+npx skills add https://github.com/getsentry/sentry-agent-skills
+```
+
+<Alert level="info" title="Cursor users">
+
+Agent skills require Cursor Nightly. Enable via: **Cursor Settings > Rules > Import Settings > Agent Skills**
+
+</Alert>
+
+## Quick Reference
+
+Paths where each client looks for skills: **user-level** (all your projects) and **project-level** (current repository only).
+
+| Client          | User-Level Path             | Project-Level Path |
+| --------------- | --------------------------- | ------------------ |
+| **Claude Code** | `~/.claude/skills/`         | `.claude/skills/`  |
+| **Codex**       | `~/.codex/skills/`          | `.codex/skills/`   |
+| **Copilot**     | `~/.copilot/skills/`        | `.github/skills/`  |
+| **Cursor**      | `~/.cursor/skills/`         | `.cursor/skills/`  |
+| **OpenCode**    | `~/.config/opencode/skill/` | `.opencode/skill/` |
+| **AmpCode**     | `~/.config/agents/skills/`  | `.agents/skills/`  |
+
+## Usage
+
+Once installed, your AI assistant will automatically discover the skills. Simply ask it to perform Sentry-related tasks:
+
+### Setup
+
+| What to Say                                | Skill Used                 |
+| ------------------------------------------ | -------------------------- |
+| "Set up Sentry in my Next.js app"          | `sentry-nextjs-setup`      |
+| "Add Sentry to my React app"               | `sentry-react-setup`       |
+| "Set up Sentry in React Native"            | `sentry-react-native-setup`|
+| "Add Sentry to my Python/Django/Flask app" | `sentry-python-setup`      |
+| "Set up Sentry in my Ruby/Rails app"       | `sentry-ruby-setup`        |
+| "Add performance monitoring to my app"     | `sentry-setup-tracing`     |
+| "Enable Sentry logging"                    | `sentry-setup-logging`     |
+| "Track custom metrics with Sentry"         | `sentry-setup-metrics`     |
+| "Monitor my OpenAI/LangChain calls"        | `sentry-setup-ai-monitoring`|
+
+### Debugging & Workflow
+
+| What to Say                            | Skill Used            |
+| -------------------------------------- | --------------------- |
+| "Fix the recent Sentry errors"         | `sentry-fix-issues`   |
+| "Debug the production TypeError"       | `sentry-fix-issues`   |
+| "Work through my Sentry backlog"       | `sentry-fix-issues`   |
+| "Review Sentry comments on PR #123"    | `sentry-pr-code-review`|
+| "Fix the issues Sentry found in my PR" | `sentry-pr-code-review`|
+
+The assistant will load the appropriate skill and guide you through the process.
+
+## Contributing
+
+Want to contribute a new skill? Skills follow the [Agent Skills specification](https://agentskills.io/specification). Here's what one looks like:
+
+
+Each skill is a folder with a `SKILL.md` file. The file has YAML frontmatter (`name`, `description`) and markdown instructions the AI assistant will use.
+
+```text
+skill-name/
+  SKILL.md        # Required: YAML frontmatter + markdown instructions
+```
+
+```markdown
+---
+name: skill-name
+description: Description of what this skill does and when to use it
+---
+
+# Skill Title
+
+Instructions for the AI assistant...
+```
+
+**Requirements:**
+
+1. Follow the [Agent Skills specification](https://agentskills.io/specification)
+2. Have a valid `name` (lowercase, hyphens, 1-64 characters)
+3. Include a clear `description` (1-1024 characters)
+4. **Keep skills concise** — use tables over prose, avoid obvious information
+5. Include an "Invoke This Skill When" section with trigger phrases
+6. Verify technical details against Sentry docs
+
+### Style Guidelines
+
+- Prefer tables over paragraphs for reference information
+- Use phases/steps for multi-stage workflows
+- Include version requirements where applicable
+- Add troubleshooting tables for common issues
+- Target ~100-200 lines per skill to minimize token usage
+
+Submit contributions to the [sentry-agent-skills repository](https://github.com/getsentry/sentry-agent-skills).
+
+</StepComponent>

docs/ai/index.mdx

@@ -0,0 +1,53 @@
+---
+title: Sentry for AI
+sidebar_order: 1
+description: "Connect Sentry to your AI coding assistants and workflows. Install agent skills, use the MCP server, or add monitoring to your AI applications."
+new: true
+keywords:
+  - AI
+  - artificial intelligence
+  - LLM
+  - machine learning
+  - MCP
+  - Model Context Protocol
+  - agent skills
+  - AI monitoring
+  - vibe coding
+  - Claude
+  - Cursor
+  - Copilot
+---
+
+<LinkCardGrid>
+  <LinkCard
+    href="/ai/agent-skills/"
+    icon="🛠️"
+    title="Agent Skills"
+    description="Teach your AI coding assistant how to set up and configure Sentry. Works with Claude Code, Cursor, GitHub Copilot, and more."
+    className="w-full md:w-[calc(50%-12px)]"
+  />
+  <LinkCard
+    href="/ai/mcp/"
+    icon="🔌"
+    title="Sentry MCP Server"
+    description="Connect your AI assistant directly to Sentry using the Model Context Protocol for real-time error analysis and debugging."
+    className="w-full md:w-[calc(50%-12px)]"
+  />
+  <LinkCard
+    href="/ai/monitoring/"
+    icon="📊"
+    title="AI Monitoring"
+    description="Add Sentry monitoring and debugging to your AI agents and MCP servers. Track LLM calls, token usage, and tool executions."
+    className="w-full md:w-[calc(50%-12px)]"
+  />
+</LinkCardGrid>
+
+## AI In Sentry
+
+Looking for Sentry's AI-powered debugging features? Sentry uses AI to help you debug faster with automated root cause analysis, fix suggestions, and AI-powered PR reviews.
+
+**Key features:**
+- **[Seer](/product/ai-in-sentry/seer/)** - AI debugging agent with automated root cause analysis and code fixes
+- **[AI Code Review](/product/ai-in-sentry/ai-code-review/)** - Get error predictions and code reviews on your pull requests
+
+[Learn more about AI In Sentry](/product/ai-in-sentry/)

docs/product/sentry-mcp/index.mdx → docs/ai/mcp.mdx

@@ -1,10 +1,21 @@
 ---
 title: Sentry MCP Server
-sidebar_order: 120
+sidebar_order: 20
 description: >-
   Enable secure connectivity between Sentry issues and debugging data, and LLM
   clients, using a Model Context Protocol (MCP) server.
-og_image: /og-images/product-sentry-mcp.png
+keywords:
+  - MCP
+  - Model Context Protocol
+  - AI integration
+  - Claude
+  - Cursor
+  - debugging
+  - OAuth
+  - remote MCP
+  - Seer
+  - autofix
+og_image: /og-images/ai-mcp.png
 ---
 
 <Alert>

docs/product/insights/ai/agents/costs.mdx → docs/ai/monitoring/agents/costs.mdx

@@ -4,7 +4,7 @@ sidebar_order: 15
 description: Learn how Sentry calculates AI model costs, where pricing data comes from, and what's not covered.
 ---
 
-The **Model Cost** widget in the [AI Agents Dashboard](/product/insights/ai/agents/dashboard/) Models tab shows estimated costs for your LLM usage. This page explains how those costs are calculated.
+The **Model Cost** widget in the [AI Agents Dashboard](/ai/monitoring/agents/dashboard/) Models tab shows estimated costs for your LLM usage. This page explains how those costs are calculated.
 
 ## Data Sources
 

docs/product/insights/ai/agents/dashboard.mdx → docs/ai/monitoring/agents/dashboard.mdx

@@ -2,10 +2,17 @@
 title: AI Agents Dashboard
 sidebar_order: 10
 description: Learn how to use Sentry's AI Agents Dashboard.
-og_image: /og-images/product-insights-ai-agents-dashboard.png
+keywords:
+  - AI dashboard
+  - agent dashboard
+  - LLM traces
+  - token usage
+  - tool calls
+  - agent insights
+og_image: /og-images/ai-monitoring-agents-dashboard.png
 ---
 
-The [AI Agents Insights](https://sentry.io/orgredirect/organizations/:orgslug/insights/ai/agents/) dashboard provides a comprehensive view of your AI workflows, including executions, model costs and token usage, tool calls, and recent errors. After you've [configured the Sentry SDK](/product/insights/ai/agents/getting-started/) in your project, telemetry data is collected and displayed in the dashboard to support analysis of system behavior and performance.
+The [AI Agents Insights](https://sentry.io/orgredirect/organizations/:orgslug/insights/ai/agents/) dashboard provides a comprehensive view of your AI workflows, including executions, model costs and token usage, tool calls, and recent errors. Once you've [configured the Sentry SDK](/ai/monitoring/agents/getting-started/) for your AI agent project, telemetry data is collected and displayed in the dashboard to support analysis of system behavior and performance.
 
 At the top of the page, you will be able to navigate between the three tabs: [Overview](#overview), [Models](#models) and [Tools](#tools).
 
@@ -37,7 +44,7 @@ The Models tab displays Model Cost, Tokens Used, and Token Types widgets, as wel
 ![AI Agents Monitoring Models](./img/models-tab.png)
 
 
-The Model Cost widget shows estimated costs based on token usage and model pricing. For details on how costs are calculated, where pricing data comes from, and what's not covered, see [Model Costs](/product/insights/ai/agents/costs/).
+The Model Cost widget shows estimated costs based on token usage and model pricing. For details on how costs are calculated, where pricing data comes from, and what's not covered, see [Model Costs](/ai/monitoring/agents/costs/).
 
 ## Tools
 

docs/product/insights/ai/agents/getting-started.mdx → docs/ai/monitoring/agents/getting-started.mdx

@@ -2,6 +2,14 @@
 title: Set Up
 sidebar_order: 0
 description: "Learn how to set up Sentry AI Agent Monitoring"
+keywords:
+  - AI agent setup
+  - agent monitoring setup
+  - OpenAI integration
+  - Anthropic integration
+  - LangChain integration
+  - Python AI
+  - Node.js AI
 ---
 
 Sentry AI Agent Monitoring helps you track and debug AI agent applications using our supported SDKs and integrations. Monitor your complete agent workflows from user interaction to final response, including tool calls, model interactions, and custom logic.

docs/product/insights/ai/agents/index.mdx → docs/ai/monitoring/agents/index.mdx

@@ -4,7 +4,17 @@ sidebar_order: 10
 description: >-
   Learn how to use Sentry's AI Agent monitoring tools to trace and debug your AI
   agent workflows, including agent runs, tool calls, and model interactions.
-og_image: /og-images/product-insights-ai-agents.png
+keywords:
+  - AI agents
+  - LLM monitoring
+  - agent monitoring
+  - tool calls
+  - OpenAI
+  - Anthropic
+  - LangChain
+  - token usage
+  - agent tracing
+og_image: /og-images/ai-monitoring-agents.png
 ---
 
 Sentry's AI Agent monitoring tools help you understand what's going on with your AI agent workflows. They automatically collect information about agent runs, tool calls, model interactions, and errors across your entire AI pipeline—from user interaction to final response.
@@ -21,4 +31,4 @@ To use AI Agent Monitoring, you must have an existing Sentry account and project
 
 ![AI Agents Monitoring Overview](./img/overview-tab.png)
 
-Learn how to [set up Sentry for AI Agents](/product/insights/ai/agents/getting-started/).
+Learn how to [set up Sentry for AI Agents](/ai/use-ai-in-sentry/monitoring/agents/getting-started/).

docs/product/insights/ai/agents/privacy.mdx → docs/ai/monitoring/agents/privacy.mdx

@@ -4,7 +4,14 @@ sidebar_order: 20
 description: >-
   Learn how to control data collection and protect sensitive information in AI
   agent monitoring.
-og_image: /og-images/product-insights-ai-agents-privacy.png
+keywords:
+  - AI privacy
+  - PII
+  - data scrubbing
+  - sensitive data
+  - AI security
+  - prompt privacy
+og_image: /og-images/ai-monitoring-agents-privacy.png
 ---
 
 ## SDK PII Settings

docs/ai/monitoring/index.mdx

@@ -0,0 +1,32 @@
+---
+title: AI Monitoring
+sidebar_order: 30
+description: "Monitor your AI agents and MCP servers in production with Sentry. Track LLM calls, token usage, tool executions, and agent handoffs."
+keywords:
+  - AI monitoring
+  - LLM monitoring
+  - agent monitoring
+  - MCP monitoring
+  - token usage
+  - AI observability
+  - AI tracing
+---
+
+Sentry provides comprehensive monitoring for your AI implementations. Whether you're building AI agents or MCP servers, Sentry automatically captures performance metrics, errors, and traces across your entire AI pipeline.
+
+<LinkCardGrid>
+  <LinkCard
+    href="/ai/monitoring/agents/"
+    icon="🤖"
+    title="AI Agent Monitoring"
+    description="Monitor AI agent workflows including agent runs, tool calls, model interactions, and handoffs."
+    className="w-full md:w-[calc(50%-12px)]"
+  />
+  <LinkCard
+    href="/ai/monitoring/mcp/"
+    icon="🔍"
+    title="MCP Monitoring"
+    description="Trace and debug your MCP server implementations. Monitor tool executions, resource access, and client connections."
+    className="w-full md:w-[calc(50%-12px)]"
+  />
+</LinkCardGrid>