Agent skill

Install Firecrasher

by osama-raddad in osama-raddad/FireCrasher

Add the FireCrasher crash-recovery library to an Android app and install it in the Application class.

Apache-2.0Auto-check passedMobile

Install Install Firecrasher

skills CLI
$ npx skills add osama-raddad/FireCrasher --skill install-firecrasher -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install osama-raddad/FireCrasher install-firecrasher --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/osama-raddad/FireCrasher.git skills-src && mkdir -p .claude/skills && cp -r skills-src/docs/skills/install-firecrasher .claude/skills/install-firecrasher && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
install-firecrasher
GitHub stars
147
Token cost
~562 tokens
SKILL.md length
179 words
Files
1
Skills in repo
8
Repo updated
First seen
Licence
Apache-2.0

At a glance

Add the FireCrasher crash-recovery library to an Android app and install it in the Application class.

  • Works in 3 steps: Add the JitPack repository → Add the dependency → Install in your Application class
  • Integrating FireCrasher
  • SKILL.md covers Requirements, 1. Add the JitPack repository, 2. Add the dependency and 3. Install in your Application…, plus 2 more sections
  • Reaches jitpack.io

What it does

Install Firecrasher is an agent skill from osama-raddad/FireCrasher. Add the FireCrasher crash-recovery library to an Android app and install it in the Application class. Use when integrating FireCrasher, setting up crash recovery, or when "app crashes should recover instead of closing".

Its SKILL.md is about 560 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Mobile, covering Android development. It works with Android, Gradle and Java. The repository describes itself as: FireCrasher is a Uncaught Exceptions recovery library for android. The licence is Apache-2.0.

When your agent uses it

  • Integrating FireCrasher
  • Setting up crash recovery
  • App crashes should recover instead of closing

Example prompts

  • “app crashes should recover instead of closing”
  • “/install-firecrasher”

Workflow steps

3 steps, taken from the step headings in SKILL.md.

  1. Add the JitPack repository
  2. Add the dependency
  3. Install in your Application class

What it can do on your machine

Read from SKILL.md and the folder at commit 7a06228. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are kotlin, groovy and xml).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • jitpack.io

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Install Firecrasher loads about 562 tokens when it runs. Until then it costs about 60 tokens; SKILL.md has 179 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~60
When it runs · the whole SKILL.md, loaded when a task matches
~562

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from osama-raddad/FireCrasher at commit 7a06228, republished under its Apache-2.0 licence (© osama-raddad). 179 words, ~562 tokens.

Download SKILL.mdSave it as .claude/skills/install-firecrasher/SKILL.md (or your agent's skills folder).
name
install-firecrasher
description
Add the FireCrasher crash-recovery library to an Android app and install it in the Application class. Use when integrating FireCrasher, setting up crash recovery, or when "app crashes should recover instead of closing".

Install FireCrasher

FireCrasher catches uncaught main-thread exceptions and recovers the app (restart the activity → go back → restart the app) instead of letting it die. It is distributed via JitPack.

Requirements

  • minSdk 23 or higher.
  • A toolchain that accepts Java 21 bytecode / Kotlin 2.1+ metadata (AGP 8.2+).

1. Add the JitPack repository

In settings.gradle (or the root build.gradle for older setups):

groovy
dependencyResolutionManagement {
    repositories {
        google()
        mavenCentral()
        maven { url 'https://jitpack.io' }
    }
}

2. Add the dependency

In your app module's build.gradle:

groovy
dependencies {
    implementation 'com.github.osama-raddad:FireCrasher:3.0.0'
}

3. Install in your Application class

Installation must happen in Application.onCreate, before any activity is created — FireCrasher hooks the main looper and activity lifecycle there. A bare install already recovers automatically at the evaluated level:

kotlin
class App : Application() {
    override fun onCreate() {
        super.onCreate()
        installFireCrasher()
    }
}

To take over crash handling, configure onCrash (see the report-crashes and customize-recovery skills for reporting and custom UX):

kotlin
installFireCrasher {
    onCrash {
        // `throwable`, `activity`, `level`, `retryCount` are in scope.
        recover()
    }
}

Register the Application in your manifest if it isn't already:

xml
<application android:name=".App" ... />

Verify

Build and run, then throw from a screen (e.g. a button handler) to confirm the app recovers instead of closing:

kotlin
button.setOnClickListener { throw RuntimeException("boom") }

Next

  • report-crashes — forward the crash to your crash reporter.
  • customize-recovery — show a loading/recovery UI based on the recovery level.
  • detect-native-crashes-and-anrs — capture crashes the handler can't see.

© osama-raddad, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in docs/skills/install-firecrasher of osama-raddad/FireCrasher.

Open the folder on GitHubat commit 7a06228

Compare with similar skills

Install Firecrasher next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Install Firecrasher compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Install Firecrasher this skillosama-raddad/FireCrasher147—~562Automated safety check: PassApache-2.0
Android API Diffgkd-kit/gkd43k—~796Automated safety check: PassGPL-3.0
Jugg Android Dev Loopniki914/zafiro235—~2kAutomated safety check: PassMIT
Android Audio E2Ehyochan/react-native-nitro-sound961—~814Automated safety check: PassMIT
Apc BuildJoker-x-dev/AndroidProject-Compose102—~553Automated safety check: PassNone
Sentry Android SDKgetsentry/sentry-for-ai268—~7.7kAutomated safety check: PassApache-2.0

Similar skills

  • Android API Diff

    gkd-kit/gkd

    Looks up Android framework Java and AIDL APIs across versions with the android-api-diff CLI: signatures, availability, source files and hidden-API access code.

    43k GitHub stars~796 tokensUpdated yesterday
    MobileAuto-check passed
  • Jugg Android Dev Loop

    niki914/zafiro

    A skill your agent uses when editing source files (Java/Kotlin/XML/layout/AndroidManifest/Gradle) in a Android project, or when user asks to build/deploy/verify an Android app.

    235 GitHub stars~2k tokensUpdated yesterday
    MobileAuto-check passed
  • Android Audio E2E

    hyochan/react-native-nitro-sound

    Build and run device-backed Android end-to-end checks for react-native-nitro-sound permissions, recording, playback, listeners, pause/resume, seek, speed, audio focus, lifecycle behavior, and rapid…

    961 GitHub stars~814 tokensUpdated 11 days ago
    MobileAuto-check passed
  • Apc Build

    Joker-x-dev/AndroidProject-Compose

    管理 AndroidProject-Compose 的 Gradle、版本目录、SDK、BuildConfig、构建类型、ABI、签名、混淆、应用资源和 APK/AAB 发布流程。用户要求升级依赖、修改构建配置、替换图标或启动页、配置签名、排查构建失败、缩减包体或生成发布包时使用。

    102 GitHub stars~553 tokensUpdated 24 days ago
    MobileAuto-check passed
  • Sentry Android SDK

    getsentry/sentry-for-ai

    Official

    Full Sentry SDK setup for Android. An agent skill from getsentry/sentry-for-ai.

    268 GitHub stars~7.7k tokensUpdated yesterday
    MobileAuto-check passed
  • Dt Setup Android

    Dynatrace/dynatrace-for-ai

    Instruments an existing Android project (Kotlin or Java) with the Dynatrace Mobile Agent for basic monitoring.

    163 GitHub stars~3.5k tokensUpdated 9 days ago
    MobileAuto-check passed

More from osama-raddad/FireCrasher

All 8 skills in this repo
  • Add Library Test

    osama-raddad/FireCrasher

    Add or update a Robolectric JVM unit test for the FireCrasher library.

    147 GitHub stars~612 tokensUpdated 3 mo ago
    Auto-check passed
  • Customize Recovery

    osama-raddad/FireCrasher

    Inspect FireCrasher's recovery level and show custom recovery UX (loading dialog, toast, snackbar) or force a specific recovery level.

    147 GitHub stars~624 tokensUpdated 3 mo ago
    Auto-check passed
  • Detect Native Crashes And Anrs

    osama-raddad/FireCrasher

    Report native crashes, ANRs, and low-memory kills that FireCrasher's in-process handler cannot catch, using ApplicationExitInfo on API 30+.

    147 GitHub stars~662 tokensUpdated 3 mo ago
    Auto-check passed
  • Release

    osama-raddad/FireCrasher

    Cut a new FireCrasher library release — bump the version, sync the README and ABI baseline, verify, and tag for JitPack.

    147 GitHub stars~649 tokensUpdated 3 mo ago
    Auto-check passed
  • Update Abi Baseline

    osama-raddad/FireCrasher

    Regenerate and review FireCrasher's committed public ABI baseline (firecrasher/api/firecrasher.api) after an intentional public API change.

    147 GitHub stars~508 tokensUpdated 3 mo ago
    Auto-check passed
  • Report Crashes

    osama-raddad/FireCrasher

    Forward FireCrasher-caught exceptions to a crash reporter (Crashlytics, Sentry, etc.) while still recovering the app.

    147 GitHub stars~410 tokensUpdated 3 mo ago
    Auto-check passed

Categories

Questions about Install Firecrasher

What does Install Firecrasher do?

Add the FireCrasher crash-recovery library to an Android app and install it in the Application class. Install Firecrasher is an agent skill from osama-raddad/FireCrasher. Add the FireCrasher crash-recovery library to an Android app and install it in the Application class.

When should I use Install Firecrasher?

Install Firecrasher fits situations like: integrating FireCrasher; setting up crash recovery; app crashes should recover instead of closing.

How do I install Install Firecrasher in Claude Code?

Run `npx skills add osama-raddad/FireCrasher --skill install-firecrasher -a claude-code`. Or copy the skill folder (docs/skills/install-firecrasher in osama-raddad/FireCrasher) into .claude/skills/install-firecrasher in your project. Claude Code loads it when a task matches its description.

How do I install Install Firecrasher in Codex?

Run `npx skills add osama-raddad/FireCrasher --skill install-firecrasher -a codex`. Or copy the skill folder (docs/skills/install-firecrasher in osama-raddad/FireCrasher) into .agents/skills/install-firecrasher in your project. Codex loads it when a task matches its description.

Can I use Install Firecrasher in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add osama-raddad/FireCrasher --skill install-firecrasher -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/install-firecrasher, .gemini/skills/install-firecrasher, .github/skills/install-firecrasher and .opencode/skills/install-firecrasher in your project.

What does Install Firecrasher need to run?

SKILL.md names no scripts, command-line tools or credentials: Install Firecrasher is instructions for the agent only.

Does Install Firecrasher access the network?

SKILL.md names 1 domain. In commands or code: jitpack.io; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is Install Firecrasher safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Install Firecrasher use?

Install Firecrasher is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Install Firecrasher use?

About 562 tokens (SKILL.md is roughly 2.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Install Firecrasher?

Skills that share tags, products or a category with Install Firecrasher: Android API Diff (gkd-kit/gkd, 43k stars), Jugg Android Dev Loop (niki914/zafiro, 235 stars), Android Audio E2E (hyochan/react-native-nitro-sound, 961 stars) and Apc Build (Joker-x-dev/AndroidProject-Compose, 102 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Install Firecrasher?

osama-raddad (a GitHub user) maintains it in osama-raddad/FireCrasher, which has 147 GitHub stars. The repository holds 8 skills in this directory. The repository was last updated on July 3, 2026.

Source: osama-raddad/FireCrasher on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.