sentry-ruby-sdk

Sentry Ruby SDK is a comprehensive setup wizard skill that guides adding and configuring Sentry across Ruby applications. It solves the problem of standing up complete observability — error monitoring, tracing, logging, metrics, profiling, and cron monitoring — in a Ruby project without piecing together docs, and it also handles migration from competing tools such as AppSignal, Honeybadger, Bugsnag, Rollbar, and Airbrake. It supports Rails, Sinatra, Rack, Sidekiq, and Resque.

The skill is structured as a detect-then-recommend flow. Phase 1 scans the project — using read-only grep commands over the Gemfile and source — to detect existing Sentry gems, the web framework, the web server (Puma), background job systems, the Yabeda metrics framework, competitor monitoring tools, scheduled-job libraries, and existing OpenTelemetry or StatsD/Prometheus metric patterns. Based on what it finds, it routes to the right integration path (for example, sentry-rails plus a config initializer, or the Rack middleware for Sinatra) and loads a competitor migration reference when needed. Phase 2 leads with concrete recommendations for which features to enable. A set of reference documents cover error monitoring (scopes, tags, breadcrumbs, before_send hooks, PII controls, exception filtering), tracing, logging, metrics, profiling, crons, and migration, with the SKILL noting APIs reflect sentry-ruby v6.6.2 and advising verification against official docs.

It targets Ruby and Rails developers and platform engineers adding production error and performance monitoring. Use cases include first-time Sentry installation, migrating off a competitor, wiring background-job and queue-time monitoring, and enabling structured logging or metrics. The scan commands are read-only inspection, and the guidance emphasizes scrubbing sensitive fields and evaluating privacy implications before enabling PII or local-variable capture.