From 7cd61b4c662cc8874602cbb5b51e9a4239cb2fac Mon Sep 17 00:00:00 2001
From: mathuraditya724 <mathuraditya724@gmail.com>
Date: Thu, 16 Apr 2026 13:37:44 +0530
Subject: [PATCH] Add upstream reference and expand Sentry CLI coverage

- Point to canonical Sentry CLI skill for complete docs
- Add npm/npx install alternatives for flexibility
- Include trace, span, and log commands
- Add guidance for handling large JSON output

This lets the skill stay lightweight while giving agents
access to the full CLI reference when needed.
---
 skills/.curated/sentry/SKILL.md           | 54 +++++++++++++++++++++--
 skills/.curated/sentry/agents/openai.yaml |  6 +--
 2 files changed, 53 insertions(+), 7 deletions(-)

diff --git a/skills/.curated/sentry/SKILL.md b/skills/.curated/sentry/SKILL.md
index c94f7efa..9db45bc9 100644
--- a/skills/.curated/sentry/SKILL.md
+++ b/skills/.curated/sentry/SKILL.md
@@ -1,10 +1,20 @@
 ---
 name: "sentry"
-description: "Use when the user asks to inspect Sentry issues or events, summarize recent production errors, or pull basic Sentry health data via the Sentry CLI; perform read-only queries using the `sentry` command."
+description: "Use when the user asks to inspect Sentry issues or events, summarize recent production errors, or pull basic Sentry data via the Sentry CLI; perform queries using the `sentry` command."
 ---
 
 
-# Sentry (Read-only Observability)
+# Sentry
+
+## Canonical Reference
+
+This is a quick-start guide. For the complete CLI documentation maintained by Sentry, fetch the upstream skill:
+
+```bash
+curl -sL https://raw.githubusercontent.com/getsentry/cli/main/plugins/sentry-cli/skills/sentry-cli/SKILL.md
+```
+
+Fetch the upstream when you need: release management, sourcemap uploads, dashboard widget configuration, or detailed command reference beyond what's covered here.
 
 ## Quick start
 
@@ -16,8 +26,10 @@ description: "Use when the user asks to inspect Sentry issues or events, summari
 
 If the CLI is not installed, give the user these steps:
 1. Install the Sentry CLI: `curl https://cli.sentry.dev/install -fsS | bash`
-2. Authenticate: `sentry auth login`
-3. Confirm authentication: `sentry auth status`
+2. Or via npm: `npm install -g @sentry/cli`
+3. Or zero-install: `npx -y @sentry/cli@latest <command>`
+4. Authenticate: `sentry auth login`
+5. Confirm authentication: `sentry auth status`
 - Never ask the user to paste the full token in chat. Ask them to set it locally and confirm when ready.
 
 ## Core tasks (use Sentry CLI)
@@ -81,6 +93,40 @@ sentry issue explain {ABC-123}
 sentry issue plan {ABC-123}
 ```
 
+### 8) Explore traces and performance
+
+```bash
+sentry trace list --limit 5
+sentry trace view <trace-id>
+sentry span list <trace-id>
+sentry trace logs <trace-id>
+```
+
+### 9) Inspect logs
+
+```bash
+sentry log list --limit 20
+sentry log list --query "severity:error" --limit 20
+sentry log list --follow    # Stream logs in real-time
+```
+
+## Large JSON handling
+
+Sentry JSON can be very large. Do not paste raw `--json` output into context.
+
+Use temp files and `jq`:
+
+```bash
+sentry trace view <trace-id> --json > /tmp/sentry-trace.json
+jq '.spans[] | {op, description, duration}' /tmp/sentry-trace.json
+```
+
+Or use `--fields` to limit output:
+
+```bash
+sentry issue list --json --fields shortId,title,priority,level,status --limit 10
+```
+
 ## Fallback: arbitrary API access
 
 For endpoints not covered by dedicated CLI commands, use `sentry api`:
diff --git a/skills/.curated/sentry/agents/openai.yaml b/skills/.curated/sentry/agents/openai.yaml
index 834c3181..2fd441e9 100644
--- a/skills/.curated/sentry/agents/openai.yaml
+++ b/skills/.curated/sentry/agents/openai.yaml
@@ -1,6 +1,6 @@
 interface:
-  display_name: "Sentry (Read-only Observability)"
-  short_description: "Read-only Sentry observability"
+  display_name: "Sentry"
+  short_description: "Query Sentry issues, traces, and logs"
   icon_small: "./assets/sentry-small.svg"
   icon_large: "./assets/sentry.png"
-  default_prompt: "Investigate this issue in read-only Sentry data and report likely root cause, impact, and next steps."
+  default_prompt: "Investigate this issue in Sentry and report likely root cause, impact, and next steps."