skillZs
★ LIVE SKILL TAGS ★
>>> LIVE SKILLS INDEX <<<
* OPEN SOURCE *
NO LOGIN, NO TRACKING
※ REAL INSTALL DATA ※
← back to all skills
onekeyhq/app-monorepo55 installs

1k-sentry-analysis

Analyze and fix production errors from Sentry crash reports (AppHang, ANR, crashes, stacktraces).

How do I install this agent skill?

npx skills add https://github.com/onekeyhq/app-monorepo --skill 1k-sentry-analysis
view source ↗

Is this agent skill safe to install?

  • Gen Agent Trust Hubpass

    This skill is designed for analyzing Sentry crash reports and implementing bug fixes. It is generally safe and includes a 'wait for user confirmation' requirement before applying code changes. However, because it processes external data (crash logs) and possesses powerful capabilities (Bash, Edit), it is susceptible to indirect prompt injection if a malicious log is provided.

  • Socketpass

    No alerts

  • Snykpass

    Risk: LOW · No issues

  • Runlayerwarn

    2/2 files flagged

What does this agent skill do?

Sentry Error Analysis & Fixes

Complete workflow for analyzing and fixing production errors from Sentry crash reports.

Workflow Overview

1. Obtain Sentry JSON log
   ↓
2. Analyze error
   ↓
3. Identify root cause
   ↓
4. Generate bug analysis log
   ↓
🚨 WAIT FOR USER CONFIRMATION 🚨
   ↓
5. Implement fix (only after approval)
   ↓
6. Test & verify
   ↓
7. Create PR

Critical Requirements

MUST follow these rules:

  1. ✅ Always create a bug analysis log in node_modules/.cache/bugs/ before implementing fixes
  2. 🚨 MUST wait for user confirmation before starting any code changes
  3. ✅ Bug analysis must be complete with all sections filled
  4. ✅ Use evidence-based methodology (环环相扣,逐步递进)

Quick Reference

Common Error Types

TypeDescriptionCommon Causes
AppHangiOS app frozen >5sToo many concurrent requests, main thread blocking
ANRAndroid Not RespondingHeavy operations on main thread, deadlocks
CrashApp terminatedNull pointer, memory issues, unhandled exceptions
ExceptionHandled errorNetwork failures, validation errors, state issues

Analysis Methodology

Use 6 types of proof to establish causation:

  1. Stack Trace Evidence - Error location in code
  2. Breadcrumbs Evidence - User actions leading to error
  3. Code Logic Evidence - Why the code causes the issue
  4. Timing Evidence - When and how often it occurs
  5. Device/Platform Evidence - Affected platforms/devices
  6. Fix Verification - Testing confirms fix works

Common Fix Patterns

// Pattern 1: Concurrent request control
async function executeBatched<T>(
  tasks: Array<() => Promise<T>>,
  concurrency = 3,
): Promise<Array<PromiseSettledResult<T>>> {
  const results: Array<PromiseSettledResult<T>> = [];
  for (let i = 0; i < tasks.length; i += concurrency) {
    const batch = tasks.slice(i, i + concurrency);
    const batchResults = await Promise.allSettled(
      batch.map((task) => task()),
    );
    results.push(...batchResults);
  }
  return results;
}

// Pattern 2: Main thread offloading (React Native)
import { InteractionManager } from 'react-native';

InteractionManager.runAfterInteractions(() => {
  // Heavy operation here
});

// Pattern 3: Error boundary
<ErrorBoundary fallback={<ErrorFallback />}>
  <Component />
</ErrorBoundary>

Detailed Guide

For comprehensive Sentry error analysis workflow, see fix-sentry-errors.md.

Topics covered:

  • Obtaining Sentry JSON logs
  • Python-based quick analysis
  • Bug analysis log template
  • 6 types of proof methodology
  • Root cause identification
  • Common fix patterns (AppHang, ANR, Crashes)
  • Real-world case studies
  • Testing and verification
  • PR creation workflow

Key Files

PurposeLocation
Bug analysis logsnode_modules/.cache/bugs/
Sentry configpackages/shared/src/modules/sentry/
Error boundariespackages/kit/src/components/ErrorBoundary/

When to Use This Skill

  • Analyzing iOS AppHang errors (5+ second freezes)
  • Fixing Android ANR (Application Not Responding)
  • Investigating crash reports with stack traces
  • Understanding user actions before crashes (breadcrumbs)
  • Creating evidence-based bug analysis reports
  • Implementing fixes for production errors

Related Skills

  • /1k-performance - Performance optimization patterns
  • /1k-error-handling - Error handling best practices
  • /1k-sentry - Sentry configuration and filtering
  • /1k-code-quality - Lint fixes and code quality

Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.

<a href="https://skillzs.dev/skills/onekeyhq/app-monorepo/1k-sentry-analysis">View 1k-sentry-analysis on skillZs</a>