Phone Harness
ShawnPana/phone-harness
Control the user's phone - an iPhone through the Mac's iPhone Mirroring window, an Android over adb, a rented cloud Android, or a cloud iPhone over HTTPS: open apps, tap, type, swipe, read the screen.
Forward FireCrasher-caught exceptions to a crash reporter (Crashlytics, Sentry, etc.) while still recovering the app.
Install Report Crashes
$ npx skills add osama-raddad/FireCrasher --skill report-crashes -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install osama-raddad/FireCrasher report-crashes --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/osama-raddad/FireCrasher.git skills-src && mkdir -p .claude/skills && cp -r skills-src/docs/skills/report-crashes .claude/skills/report-crashes && rm -rf skills-srcUse ~/.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/
Install the "report-crashes" agent skill from https://github.com/osama-raddad/FireCrasher/tree/master/docs/skills/report-crashes into .claude/skills/report-crashes/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "report-crashes", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/osama-raddad/FireCrasher/tree/master/docs/skills/report-crashesType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add osama-raddad/FireCrasher --skill report-crashes -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install osama-raddad/FireCrasher report-crashes --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/osama-raddad/FireCrasher.git skills-src && mkdir -p .agents/skills && cp -r skills-src/docs/skills/report-crashes .agents/skills/report-crashes && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "report-crashes" agent skill from https://github.com/osama-raddad/FireCrasher/tree/master/docs/skills/report-crashes into .agents/skills/report-crashes/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "report-crashes", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add osama-raddad/FireCrasher --skill report-crashes -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install osama-raddad/FireCrasher report-crashes --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/osama-raddad/FireCrasher.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/docs/skills/report-crashes .cursor/skills/report-crashes && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "report-crashes" agent skill from https://github.com/osama-raddad/FireCrasher/tree/master/docs/skills/report-crashes into .cursor/skills/report-crashes/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "report-crashes", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/osama-raddad/FireCrasher.git --path docs/skills/report-crashes--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add osama-raddad/FireCrasher --skill report-crashes -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install osama-raddad/FireCrasher report-crashes --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/osama-raddad/FireCrasher.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/docs/skills/report-crashes .gemini/skills/report-crashes && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "report-crashes" agent skill from https://github.com/osama-raddad/FireCrasher/tree/master/docs/skills/report-crashes into .gemini/skills/report-crashes/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "report-crashes", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install osama-raddad/FireCrasher report-crashesInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add osama-raddad/FireCrasher --skill report-crashes -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/osama-raddad/FireCrasher.git skills-src && mkdir -p .github/skills && cp -r skills-src/docs/skills/report-crashes .github/skills/report-crashes && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "report-crashes" agent skill from https://github.com/osama-raddad/FireCrasher/tree/master/docs/skills/report-crashes into .github/skills/report-crashes/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "report-crashes", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add osama-raddad/FireCrasher --skill report-crashes -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install osama-raddad/FireCrasher report-crashes --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/osama-raddad/FireCrasher.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/docs/skills/report-crashes .opencode/skills/report-crashes && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "report-crashes" agent skill from https://github.com/osama-raddad/FireCrasher/tree/master/docs/skills/report-crashes into .opencode/skills/report-crashes/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "report-crashes", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
report-crashes- GitHub stars
- 147
- Token cost
- ~410 tokens
- SKILL.md length
- 123 words
- Files
- 1
- Skills in repo
- 8
- Repo updated
- First seen
- Licence
- Apache-2.0
At a glance
Forward FireCrasher-caught exceptions to a crash reporter (Crashlytics, Sentry, etc.) while still recovering the app.
- Wiring crash reporting
- SKILL.md covers Log, then recover, Add context and Don't forget out-of-process…
- Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
- Logging non-fatals
What it does
Report Crashes is an agent skill from osama-raddad/FireCrasher. Forward FireCrasher-caught exceptions to a crash reporter (Crashlytics, Sentry, etc.) while still recovering the app. Use when wiring crash reporting, logging non-fatals, or "make sure we still get crash reports after recovery".
Its SKILL.md is about 410 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 Mobile testing and debugging. It works with Sentry and Android. 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
- Wiring crash reporting
- Logging non-fatals
- Make sure we still get crash reports after recovery
Example prompts
- “make sure we still get crash reports after recovery”
- “/report-crashes”
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).
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
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
Report Crashes loads about 410 tokens when it runs. Until then it costs about 61 tokens; SKILL.md has 123 words of instructions outside code blocks.
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). 123 words, ~410 tokens.
Download SKILL.mdSave it as
.claude/skills/report-crashes/SKILL.md (or your agent's skills folder).- name
- report-crashes
- description
- Forward FireCrasher-caught exceptions to a crash reporter (Crashlytics, Sentry, etc.) while still recovering the app. Use when wiring crash reporting, logging non-fatals, or "make sure we still get crash reports after recovery".
Report crashes while recovering
FireCrasher keeps the app alive, but you still want every crash recorded.
The onCrash handler gives you the throwable before recovery runs — log it
there, then call recover(). Because the app survives, these arrive at your
reporter as non-fatal / handled exceptions, not fatal crashes.
Log, then recover
installFireCrasher {
onCrash {
// 1. Report first, so nothing is lost if recovery itself struggles.
FirebaseCrashlytics.getInstance().recordException(throwable) // or Sentry.captureException(throwable)
// 2. Then recover.
recover()
}
}The order matters: report before recover() so the report is captured even
if a subsequent recovery attempt kills the process.
Add context
retryCount (in onCrash scope) tells you how many times FireCrasher has
already tried to recover this crash — useful signal on a report:
onCrash {
FirebaseCrashlytics.getInstance().apply {
setCustomKey("firecrasher_retry", retryCount)
recordException(throwable)
}
recover()
}Don't forget out-of-process deaths
onCrash only sees JVM exceptions on threads FireCrasher controls. Native
crashes and ANRs never reach it — report those separately via the
detect-native-crashes-and-anrs skill (onPreviousProcessExit).
© 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/report-crashes of osama-raddad/FireCrasher.
Open the folder on GitHubat commit 7a06228
Compare with similar skills
Report Crashes 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.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Report Crashes this skillosama-raddad/FireCrasher | 147 | — | ~410 | Automated safety check: Pass | Apache-2.0 | |
| Phone HarnessShawnPana/phone-harness | 3.2k | — | ~7.7k | Automated safety check: Pass | MIT | |
| Mobile QAtloncorp/tlon-apps | 107 | — | ~2.4k | Automated safety check: Pass | MIT | |
| Androidyang1ming/android-harness | 176 | — | ~259 | Automated safety check: Pass | MIT | |
| Debug Receiverstimusus/Shuttle2 | 229 | — | ~1.9k | Automated safety check: Pass | Apache-2.0 | |
| Debug Bridgegetknit/knit | 133 | — | ~2.3k | Automated safety check: Pass | GPL-3.0 |
Similar skills
Mobile QA
tloncorp/tlon-apps
Run a mobile QA checklist on a physical Android device over adb for tlon-apps, then triage what fails into fixes.
Android
yang1ming/android-harness
Direct Android device control through ADB. An agent skill from yang1ming/android-harness.
Debug Receivers
timusus/Shuttle2
Drive the S2 debug build's playback and queue over ADB broadcasts — play the whole library, play/pause, skip, seek, remove a queue item, toggle shuffle/repeat, dump playback state as JSON, reimport…
Debug Bridge
getknit/knit
Drive and verify Knit on a device or emulator through the headless debug bridge (am broadcast to app.getknit.knit.debug.<ACTION, replies as JSON) — send a message on one phone and confirm it landed…
Capturing Screenshots And Screenrecord
skydoves/android-testing-skills
A skill your agent uses to capture visual artefacts from a device for test failures, golden image generation, QA repro, and demo videos.
More from osama-raddad/FireCrasher
All 8 skills in this repoAdd Library Test
osama-raddad/FireCrasher
Add or update a Robolectric JVM unit test for the FireCrasher library.
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.
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+.
Install Firecrasher
osama-raddad/FireCrasher
Add the FireCrasher crash-recovery library to an Android app and install it in the Application class.
Release
osama-raddad/FireCrasher
Cut a new FireCrasher library release — bump the version, sync the README and ABI baseline, verify, and tag for JitPack.
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.
Related
Categories
Questions about Report Crashes
What does Report Crashes do?
Forward FireCrasher-caught exceptions to a crash reporter (Crashlytics, Sentry, etc.) while still recovering the app. Report Crashes is an agent skill from osama-raddad/FireCrasher.) while still recovering the app.
When should I use Report Crashes?
Report Crashes fits situations like: wiring crash reporting; logging non-fatals; make sure we still get crash reports after recovery.
How do I install Report Crashes in Claude Code?
Run `npx skills add osama-raddad/FireCrasher --skill report-crashes -a claude-code`. Or copy the skill folder (docs/skills/report-crashes in osama-raddad/FireCrasher) into .claude/skills/report-crashes in your project. Claude Code loads it when a task matches its description.
How do I install Report Crashes in Codex?
Run `npx skills add osama-raddad/FireCrasher --skill report-crashes -a codex`. Or copy the skill folder (docs/skills/report-crashes in osama-raddad/FireCrasher) into .agents/skills/report-crashes in your project. Codex loads it when a task matches its description.
Can I use Report Crashes 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 report-crashes -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/report-crashes, .gemini/skills/report-crashes, .github/skills/report-crashes and .opencode/skills/report-crashes in your project.
What does Report Crashes need to run?
SKILL.md names no scripts, command-line tools or credentials: Report Crashes is instructions for the agent only.
Does Report Crashes access the network?
SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.
Is Report Crashes 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 Report Crashes use?
Report Crashes 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 Report Crashes use?
About 410 tokens (SKILL.md is roughly 1.6k 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 Report Crashes?
Skills that share tags, products or a category with Report Crashes: Phone Harness (ShawnPana/phone-harness, 3.2k stars), Mobile QA (tloncorp/tlon-apps, 107 stars), Android (yang1ming/android-harness, 176 stars) and Debug Receivers (timusus/Shuttle2, 229 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Report Crashes?
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.