chore(skill): regenerate skill files with widget types and layout info

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: betegon

plugins/sentry-cli/skills/sentry-cli/SKILL.md

@@ -112,6 +112,48 @@ sentry api /api/0/organizations/my-org/
 sentry api /api/0/organizations/my-org/projects/ --method POST --data '{"name":"new-project","platform":"python"}'
 ```
 
+### Dashboard Layout
+
+Sentry dashboards use a **6-column grid**. When adding widgets, aim to fill complete rows (widths should sum to 6).
+
+Default widget sizes by display type:
+
+| Display Type | Width | Height | Notes |
+|---|---|---|---|
+| `big_number` | 2 | 1 | Compact KPI — place 3 per row (2+2+2=6) |
+| `line` | 3 | 2 | Half-width chart — place 2 per row (3+3=6) |
+| `area` | 3 | 2 | Half-width chart — place 2 per row |
+| `bar` | 3 | 2 | Half-width chart — place 2 per row |
+| `table` | 6 | 2 | Full-width — always takes its own row |
+
+Common display types for general dashboards: `big_number`, `line`, `area`, `bar`, `table`.
+
+Specialized types (only use when specifically requested): `stacked_area`, `top_n`, `categorical_bar`, `text`.
+
+Internal types (avoid unless user explicitly asks): `details`, `wheel`, `rage_and_dead_clicks`, `server_tree`, `agents_traces_table`.
+
+Available datasets: `spans` (default, covers most use cases), `discover`, `issue`, `error-events`, `transaction-like`, `metrics`, `logs`.
+
+Run `sentry dashboard widget types --json` for the full machine-readable list including aggregate functions.
+
+**Row-filling examples:**
+
+```bash
+# 3 KPIs filling one row (2+2+2 = 6)
+sentry dashboard widget add <dashboard> "Error Count" --display big_number --query count
+sentry dashboard widget add <dashboard> "P95 Duration" --display big_number --query p95:span.duration
+sentry dashboard widget add <dashboard> "Throughput" --display big_number --query epm
+
+# 2 charts filling one row (3+3 = 6)
+sentry dashboard widget add <dashboard> "Errors Over Time" --display line --query count
+sentry dashboard widget add <dashboard> "Latency Over Time" --display line --query p95:span.duration
+
+# Full-width table (6 = 6)
+sentry dashboard widget add <dashboard> "Top Endpoints" --display table \
+  --query count --query p95:span.duration \
+  --group-by transaction --sort -count --limit 10
+```
+
 ### Common Mistakes
 
 - **Wrong issue ID format**: Use `PROJECT-123` (short ID), not the numeric ID `123456789`. The short ID includes the project prefix.
@@ -229,6 +271,7 @@ Manage Sentry dashboards
 - `sentry dashboard widget add <args...>` — Add a widget to a dashboard
 - `sentry dashboard widget edit <args...>` — Edit a widget in a dashboard
 - `sentry dashboard widget delete <args...>` — Delete a widget from a dashboard
+- `sentry dashboard widget types <args...>` — Show available widget display types and layout info
 
 → Full flags and examples: `references/dashboards.md`
 

plugins/sentry-cli/skills/sentry-cli/references/dashboards.md

@@ -90,7 +90,7 @@ sentry dashboard widget add 'Frontend Performance' "Error Count" --display big_n
 Add a widget to a dashboard
 
 **Flags:**
-- `-d, --display <value> - Display type (line, bar, table, big_number, ...)`
+- `-d, --display <value> - Display type (big_number, line, area, bar, table, stacked_area, top_n, text, ...)`
 - `--dataset <value> - Widget dataset (default: spans)`
 - `-q, --query <value>... - Aggregate expression (e.g. count, p95:span.duration)`
 - `-w, --where <value> - Search conditions filter (e.g. is:unresolved)`
@@ -106,7 +106,7 @@ Edit a widget in a dashboard
 - `-i, --index <value> - Widget index (0-based)`
 - `-t, --title <value> - Widget title to match`
 - `--new-title <value> - New widget title`
-- `-d, --display <value> - Display type (line, bar, table, big_number, ...)`
+- `-d, --display <value> - Display type (big_number, line, area, bar, table, stacked_area, top_n, text, ...)`
 - `--dataset <value> - Widget dataset (default: spans)`
 - `-q, --query <value>... - Aggregate expression (e.g. count, p95:span.duration)`
 - `-w, --where <value> - Search conditions filter (e.g. is:unresolved)`
@@ -122,4 +122,8 @@ Delete a widget from a dashboard
 - `-i, --index <value> - Widget index (0-based)`
 - `-t, --title <value> - Widget title to match`
 
+### `sentry dashboard widget types <args...>`
+
+Show available widget display types and layout info
+
 All commands also support `--json`, `--fields`, `--help`, `--log-level`, and `--verbose` flags.