Files
getsentry__sentry-agent-skills/docs
Daniel Griesser 2a54c46058 Wizard-first setup guidance for frontend/mobile SDK skills (#17)
* docs: wizard-first setup guidance for frontend/mobile SDK skills

Add systematic guidance for recommending the Sentry wizard CLI as the
primary setup path when a wizard integration exists for the target
framework. The wizard handles the full auth flow (browser login,
org/project selection, auth token creation/download) and source map
upload configuration automatically — the two things most commonly
misconfigured in manual frontend setups.

Changes:

- docs/sdk-skill-philosophy.md: Add 'Wizard-First for Framework SDKs'
  section with pattern template, known wizard integrations table, and
  'Source Maps: The Non-Negotiable for Frontend' checklist. Update the
  scaffold to show wizard option in Phase 3.

- skills/sentry-sdk-skill-creator/SKILL.md: Add wizard research step
  in Phase 2, wizard-first + source maps as key principles (#2, #3),
  wizard/source-map structure in the SKILL.md template, source map
  note for frontend reference files, and two new checklist items.

- skills/sentry-svelte-sdk/SKILL.md: Upgrade wizard description from
  'Easiest' to 'Recommended', add auth flow details.

- skills/sentry-react-native-sdk/SKILL.md: Add auth flow details to
  wizard description.

- skills/sentry-cocoa-sdk/SKILL.md: Expand wizard description with
  interactive auth flow and dSYM upload details.

* docs(sdk-skill-creator): replace hard 500-line limit with qualitative focus guidance

The arbitrary 500-line cap on main SKILL.md files could force bad
tradeoffs — splitting content that belongs together or omitting useful
context to stay under a number. Replace it with qualitative guidance:
keep the main file focused on the wizard flow, quick start, and
reference dispatch; deep-dive content goes in references/. Be thorough
but not redundant.

Updated in SKILL.md (Phase 3 intro, review pass, checklist) and in
references/quality-checklist.md (spec compliance table, final
verification script).
2026-02-27 09:23:39 +01:00
..