From 4078b08151ffed90ff135c8821330015cb35a89e Mon Sep 17 00:00:00 2001
From: Sergiy Dybskiy <sergiy.dybskiy@sentry.io>
Date: Fri, 30 Jan 2026 21:04:48 -0500
Subject: [PATCH] docs: add agentic usage documentation

Add documentation for the Sentry CLI skill that enables AI coding agents
to interact with Sentry. Includes sidebar entry and link from Installation.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
---
 docs/astro.config.mjs                     |  5 ++-
 docs/src/content/docs/agentic-usage.md    | 41 +++++++++++++++++++++++
 docs/src/content/docs/getting-started.mdx |  1 +
 3 files changed, 46 insertions(+), 1 deletion(-)
 create mode 100644 docs/src/content/docs/agentic-usage.md

diff --git a/docs/astro.config.mjs b/docs/astro.config.mjs
index 48e0c7f4..a12158ad 100644
--- a/docs/astro.config.mjs
+++ b/docs/astro.config.mjs
@@ -193,7 +193,10 @@ export default defineConfig({
         },
         {
           label: "Resources",
-          items: [{ label: "Contributing", slug: "contributing" }],
+          items: [
+            { label: "Agentic Usage", slug: "agentic-usage" },
+            { label: "Contributing", slug: "contributing" },
+          ],
         },
       ],
       customCss: ["./src/styles/custom.css"],
diff --git a/docs/src/content/docs/agentic-usage.md b/docs/src/content/docs/agentic-usage.md
new file mode 100644
index 00000000..4abdb332
--- /dev/null
+++ b/docs/src/content/docs/agentic-usage.md
@@ -0,0 +1,41 @@
+---
+title: Agentic Usage
+description: Enable AI coding agents to use the Sentry CLI
+---
+
+AI coding agents like Claude Code can use the Sentry CLI through the skill system. This allows agents to interact with Sentry directly from your development environment.
+
+## Adding the Skill
+
+Add the Sentry CLI skill to your agent:
+
+```bash
+npx skills add https://cli.sentry.dev
+```
+
+This registers the Sentry CLI as a skill that your agent can invoke when needed.
+
+## Capabilities
+
+With this skill, agents can:
+
+- **View issues** - List and inspect Sentry issues from your projects
+- **Inspect events** - Look at specific error events and their details
+- **Browse projects** - List projects and organizations you have access to
+- **Make API calls** - Execute arbitrary Sentry API requests
+- **Authenticate** - Help you set up CLI authentication
+
+## How It Works
+
+When you ask your agent about Sentry errors or want to investigate an issue, the agent can use this skill to fetch real data from your Sentry account. For example:
+
+- "Show me the latest issues in my project"
+- "What's the stack trace for ISSUE-123?"
+- "List all projects in my organization"
+
+The skill uses your existing CLI authentication, so you'll need to run `sentry auth login` first if you haven't already.
+
+## Requirements
+
+- An authenticated Sentry CLI installation (`sentry auth login`)
+- An AI coding agent that supports the skills system (e.g., Claude Code)
diff --git a/docs/src/content/docs/getting-started.mdx b/docs/src/content/docs/getting-started.mdx
index 67e51816..fb87b9c8 100644
--- a/docs/src/content/docs/getting-started.mdx
+++ b/docs/src/content/docs/getting-started.mdx
@@ -86,3 +86,4 @@ Once authenticated, you can start using the CLI:
 - [Issue commands](../commands/issue/) - Track and manage issues
 - [Event commands](../commands/event/) - Inspect events
 - [API commands](../commands/api/) - Direct API access
+- [Agentic Usage](../agentic-usage/) - Enable AI coding agents to use the CLI