All Skills

SDK Setup PHP SDK Sentry PHP SDK Opinionated wizard that scans your PHP project and guides you through complete Sentry setup. Invoke This Skill When User asks to "add Sentry to PHP" or "setup Sentry" in a PHP app User wants error monitoring, tracing, profiling, logging, metrics, or crons in PHP User mentions sentry/sentry , sentry/sentry-laravel , sentry/sentry-symfony , or Sentry + any PHP framework User wants to monitor Laravel routes, Symfony controllers, queues, scheduled tasks, or plain PHP scripts Note: SDK versions and APIs below reflect Sentry docs at time of writing (sentry/sentry 4.x, sentry/sentry-laravel 4.x, sentry/sentry-symfony 5.x). Always verify against docs.sentry.io/platforms/php/ before implementing. Phase 1: Detect Run these commands to understand the project before making recommendations:

Check existing Sentry

grep -i sentry composer.json composer.lock 2

/dev/null

Detect framework

cat composer.json | grep -E '"laravel/framework"|"symfony/framework-bundle"|"illuminate/'

Confirm framework via filesystem markers

ls artisan 2

/dev/null && echo "Laravel detected" ls bin/console 2

/dev/null && echo "Symfony detected"

Detect queue systems

grep -E '"laravel/horizon"|"symfony/messenger"' composer.json 2

/dev/null

Detect AI libraries

grep -E '"openai-php|"openai/|anthropic|llm' composer.json 2

/dev/null

Check for companion frontend

ls frontend/ resources/js/ assets/ 2

/dev/null cat package.json 2

/dev/null | grep -E '"react"|"svelte"|"vue"|"next"' What to note: Is sentry/sentry (or -laravel / -symfony ) already in composer.json ? If yes, check if the init call exists — may just need feature config. Framework detected? Laravel (has artisan + laravel/framework in composer.json), Symfony (has bin/console + symfony/framework-bundle ), or plain PHP . Queue system? (Laravel Queue / Horizon, Symfony Messenger need queue worker configuration.) AI libraries? (No PHP AI auto-instrumentation yet — document manually if needed.) Companion frontend? (Triggers Phase 4 cross-link.) Phase 2: Recommend Based on what you found, present a concrete proposal. Don't ask open-ended questions — lead with a recommendation: Always recommended (core coverage): ✅ Error Monitoring — captures unhandled exceptions and PHP errors ✅ Logging — Monolog integration (Laravel/Symfony auto-configure; plain PHP uses MonologHandler ) Recommend when detected: ✅ Tracing — web framework detected (Laravel/Symfony auto-instrument HTTP, DB, Twig/Blade, cache) ⚡ Profiling — production apps where performance matters (requires excimer PHP extension, Linux/macOS only) ⚡ Crons — scheduler patterns detected (Laravel Scheduler, Symfony Scheduler, custom cron jobs) ⚡ Metrics — business KPIs or SLO tracking (beta; uses TraceMetrics API) Recommendation matrix: Feature Recommend when... Reference Error Monitoring Always — non-negotiable baseline ${SKILL_ROOT}/references/error-monitoring.md Tracing Laravel/Symfony detected, or manual spans needed ${SKILL_ROOT}/references/tracing.md Profiling Production + excimer extension available ${SKILL_ROOT}/references/profiling.md Logging Always ; Monolog for Laravel/Symfony ${SKILL_ROOT}/references/logging.md Metrics Business events or SLO tracking needed (beta) ${SKILL_ROOT}/references/metrics.md Crons Scheduler or cron patterns detected ${SKILL_ROOT}/references/crons.md Propose: "I recommend Error Monitoring + Tracing [+ Logging]. Want Profiling, Crons, or Metrics too?" Phase 3: Guide Install

Plain PHP

composer require sentry/sentry "^4.0"

Laravel

composer require sentry/sentry-laravel "^4.0"

Symfony

composer require sentry/sentry-symfony "^5.0" System requirements: PHP 7.2 or later Extensions: ext-json , ext-mbstring , ext-curl (all required) excimer PECL extension (Linux/macOS only — required for profiling) Framework-Specific Initialization Plain PHP Place \Sentry\init() at the top of your entry point ( index.php , bootstrap.php , or equivalent), before any application code: