Maui AI Debugging
Redth/Maui.Gtk
End-to-end workflow for building, deploying, inspecting, and debugging .NET MAUI and MAUI Blazor Hybrid apps as an AI agent.
Explain why a program crashed from its crash report or core dump, and whether it is worth reporting
Install Diagnose Crash
$ npx skills add iamlukethedev/Herald-OS --skill diagnose-crash -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install iamlukethedev/Herald-OS diagnose-crash --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/iamlukethedev/Herald-OS.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/herald-os-bridge/skills/diagnose-crash .claude/skills/diagnose-crash && 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 "diagnose-crash" agent skill from https://github.com/iamlukethedev/Herald-OS/tree/main/plugins/herald-os-bridge/skills/diagnose-crash into .claude/skills/diagnose-crash/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "diagnose-crash", 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/iamlukethedev/Herald-OS/tree/main/plugins/herald-os-bridge/skills/diagnose-crashType 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 iamlukethedev/Herald-OS --skill diagnose-crash -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install iamlukethedev/Herald-OS diagnose-crash --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/iamlukethedev/Herald-OS.git skills-src && mkdir -p .agents/skills && cp -r skills-src/plugins/herald-os-bridge/skills/diagnose-crash .agents/skills/diagnose-crash && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "diagnose-crash" agent skill from https://github.com/iamlukethedev/Herald-OS/tree/main/plugins/herald-os-bridge/skills/diagnose-crash into .agents/skills/diagnose-crash/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "diagnose-crash", 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 iamlukethedev/Herald-OS --skill diagnose-crash -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install iamlukethedev/Herald-OS diagnose-crash --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/iamlukethedev/Herald-OS.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/plugins/herald-os-bridge/skills/diagnose-crash .cursor/skills/diagnose-crash && 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 "diagnose-crash" agent skill from https://github.com/iamlukethedev/Herald-OS/tree/main/plugins/herald-os-bridge/skills/diagnose-crash into .cursor/skills/diagnose-crash/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "diagnose-crash", 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/iamlukethedev/Herald-OS.git --path plugins/herald-os-bridge/skills/diagnose-crash--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 iamlukethedev/Herald-OS --skill diagnose-crash -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install iamlukethedev/Herald-OS diagnose-crash --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/iamlukethedev/Herald-OS.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/plugins/herald-os-bridge/skills/diagnose-crash .gemini/skills/diagnose-crash && 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 "diagnose-crash" agent skill from https://github.com/iamlukethedev/Herald-OS/tree/main/plugins/herald-os-bridge/skills/diagnose-crash into .gemini/skills/diagnose-crash/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "diagnose-crash", 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 iamlukethedev/Herald-OS diagnose-crashInstalls 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 iamlukethedev/Herald-OS --skill diagnose-crash -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/iamlukethedev/Herald-OS.git skills-src && mkdir -p .github/skills && cp -r skills-src/plugins/herald-os-bridge/skills/diagnose-crash .github/skills/diagnose-crash && 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 "diagnose-crash" agent skill from https://github.com/iamlukethedev/Herald-OS/tree/main/plugins/herald-os-bridge/skills/diagnose-crash into .github/skills/diagnose-crash/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "diagnose-crash", 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 iamlukethedev/Herald-OS --skill diagnose-crash -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install iamlukethedev/Herald-OS diagnose-crash --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/iamlukethedev/Herald-OS.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/plugins/herald-os-bridge/skills/diagnose-crash .opencode/skills/diagnose-crash && 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 "diagnose-crash" agent skill from https://github.com/iamlukethedev/Herald-OS/tree/main/plugins/herald-os-bridge/skills/diagnose-crash into .opencode/skills/diagnose-crash/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "diagnose-crash", 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
diagnose-crash- GitHub stars
- 408
- Token cost
- ~964 tokens
- SKILL.md length
- 570 words
- Files
- 1
- Skills in repo
- 8
- Repo updated
- First seen
- Licence
- MIT
At a glance
Explain why a program crashed from its crash report or core dump, and whether it is worth reporting
- Works in 3 steps: Gather the facts (all read-only) → Read it like an engineer → Tell the person
- Tasks that involve Mobile testing and debugging
- SKILL.md covers 1. Gather the facts (all…, 2. Read it like an engineer, 3. Tell the person and Norms
- Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
What it does
Diagnose Crash is an agent skill from iamlukethedev/Herald-OS. Explain why a program crashed from its crash report or core dump, and whether it is worth reporting
Its SKILL.md is about 960 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 Linux and macOS. The repository describes itself as: An agent-native operating system, with Hermes Agent as the interface. Independent project, not affiliated with Nous Research. The licence is MIT.
When your agent uses it
- Tasks that involve Mobile testing and debugging
Example prompts
- “/diagnose-crash”
Workflow steps
3 steps, taken from the step headings in SKILL.md.
What it can do on your machine
Read from SKILL.md and the folder at commit 7babe0c. 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.
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
Diagnose Crash loads about 964 tokens when it runs. Until then it costs about 29 tokens; SKILL.md has 570 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 iamlukethedev/Herald-OS at commit 7babe0c, republished under its MIT licence (© iamlukethedev). 570 words, ~964 tokens.
Download SKILL.mdSave it as
.claude/skills/diagnose-crash/SKILL.md (or your agent's skills folder).- name
- diagnose-crash
- description
- Explain why a program crashed from its crash report or core dump, and whether it is worth reporting
Diagnose a crash
Herald OS offers this when a program on the computer crashes and the person chooses "Ask Hermes". The opening message says which program crashed, when, and where its report is. Your job: find out what happened from the evidence, explain it in plain words, and say what to do next.
1. Gather the facts (all read-only)
system_logs action=crash_report report=<path or pid>is the starting point. On macOS it returns the exception type and signal, the termination reason, the program's own last messages (app_messages) and the crashed thread's top frames; on Linux it returnscoredumpctl info, which includes a stack trace when debug symbols are installed.- No report named?
system_logs action=crasheslists recent crashes; pick the program the person means, or ask. - Context when it helps:
system_logs action=log minutes=15 level=any process=<name>for what the program logged just before;system_infofor memory pressure or a full disk;system_processes action=find name=<name>to see whether it is running again.
2. Read it like an engineer
- EXC_BAD_ACCESS / SIGSEGV / SIGBUS: the program touched memory it did not own. Usually a bug in the program or in something loaded into it (a plugin, extension, input method, driver). SIGBUS can also mean a file it had mapped went away (an ejected disk, a file replaced during an update).
- EXC_CRASH (SIGABRT): the program stopped itself on purpose.
app_messagesor the frames (abort,__assert_rtn,objc_exception_throw) usually say why. - EXC_BREAKPOINT / SIGTRAP / SIGILL: a deliberate trap, such as a Swift
fatalError, a Rust panic or an index out of range. - SIGKILL from the system, jetsam, EXC_RESOURCE: it was stopped for using too much memory or CPU.
- Termination namespace CODESIGNING: the app's signature is broken (a damaged or modified app); reinstalling fixes it.
- Crash at launch (frames in
dyldor start-up code): a broken install or update, or a missing library. - In the frames, the first one inside the program's own binary or a third-party library is the
likely culprit. System libraries at the top (
libsystem_kernel,libobjc,libc.so) only show where it stopped; look below them. A third-party name in the frames points at that component.
Show full SKILL.md (224 more words)Show less
3. Tell the person
- Lead with one or two sentences in their words: what went wrong and where ("Safari stopped while a content-blocker extension was reading a page"). Say "the report shows" for facts and "probably" for inferences; never guess past the evidence.
- Say whether it is likely to happen again and what they can do: update the app, turn off the extension, reinstall, close something that is using the memory, free disk space. Offer to do the parts you can with your tools, and do them only when they say yes.
- Say whether it is worth reporting. It is when the crash is in the program's own code and it
happens again or can be reproduced. Offer to draft the report: a summary, steps to reproduce, the
environment (from
system_info), the exception and the top frames. Replace the home folder with~and leave out anything personal. The person sends it; you never send a report anywhere. - If the report is missing or unreadable, say so and tell them what to watch for next time.
Norms
- Do not paste the raw report or long stack traces into the chat; quote the two or three lines that matter.
- Programs that crash often and do not matter to the person can be muted: the notification has a
"Mute" button, or run
os_ui action=run command=crash.mute args={"app": "<name>"}.
© iamlukethedev, MIT. 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 plugins/herald-os-bridge/skills/diagnose-crash of iamlukethedev/Herald-OS.
Open the folder on GitHubat commit 7babe0c
Compare with similar skills
Diagnose Crash 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 |
|---|---|---|---|---|---|---|
| Diagnose Crash this skilliamlukethedev/Herald-OS | 408 | — | ~964 | Automated safety check: Pass | MIT | |
| Maui AI DebuggingRedth/Maui.Gtk | 101 | — | ~4.1k | Automated safety check: Pass | MIT | |
| Engine Whats Newflutter/flutter | 180k | — | ~978 | Automated safety check: Pass | BSD-3-Clause | |
| Orca iOS Simulator Controlstablyai/orca | 89k | 1 repos | ~584 | Automated safety check: Pass | Apache-2.0 | |
| Apple Crash Log .NET Symbolicationdotnet/skills | 5.6k | 1 repos | ~2.4k | Automated safety check: Pass | MIT | |
| VPhone Guest ControlLakr233/vphone-cli | 15k | — | ~1.6k | Automated safety check: Pass | MIT |
Similar skills
Engine Whats New
flutter/flutter
Generates the "what's new" release summary and diff file for changes in the Flutter engine (//engine/src/flutter) between two releases (e.g., 3.47 vs 3.44).
Orca iOS Simulator Control
stablyai/orca
iOS Simulator control from inside Orca, with the live device view in Orca's emulator pane. Use when driving a booted Apple Simulator on macOS: taps, gestures…
- Official
Apple Crash Log .NET Symbolication
dotnet/skills
Resolves .NET runtime frames in Apple .ips crash logs to function names, source files and line numbers using dSYM symbols, atos and the Microsoft symbol server.
VPhone Guest Control
Lakr233/vphone-cli
Drives a virtual iPhone running on an Apple Silicon Mac through the vphone-launchpad-cli, from checking host setup and starting a machine to tapping, typing and installing apps in the guest.
Phoneagent
rounak/PhoneAgent
Control a connected iPhone, iOS simulator, Android emulator, or Android device from macOS through PhoneAgent's JSON-RPC bridge.
More from iamlukethedev/Herald-OS
All 8 skills in this repoHerald Os Tailor
iamlukethedev/Herald-OS
Change Herald OS itself - make and switch themes, fonts and the wallpaper, widgets, the menu bar, control-menu entries, branding, keybindings, settings, routines and hooks
Herald Sheets
iamlukethedev/Herald-OS
Work in Herald Sheets, the spreadsheet in Herald OS - read workbooks, write values and formulas (a formula from a description, explaining one, filling it down), fill a column from examples, clean…
Herald Slides
iamlukethedev/Herald-OS
Make and change presentations in Herald Slides, the presentation editor in Herald OS - a deck from a topic (an outline first, a title slide, one idea a slide, short bullets, speaker notes, a closing…
Herald Canvas
iamlukethedev/Herald-OS
Make and edit pictures in Herald Canvas, the layered image editor in Herald OS - posters, banners, thumbnails, collages and photo fixes through the canvas tool, with editable text and shape layers…
Herald Docs
iamlukethedev/Herald-OS
Write and edit documents in Herald Docs, the word processor in Herald OS - letters, cover letters, CVs, reports, memos, meeting notes, proposals, essays and newsletters drafted from a brief or a…
File Documents
iamlukethedev/Herald-OS
Find documents such as invoices among badly named files, read them, name them clearly and file them where the person keeps them, with a plan they approve and an undo
Related
Categories
Questions about Diagnose Crash
What does Diagnose Crash do?
Explain why a program crashed from its crash report or core dump, and whether it is worth reporting. Diagnose Crash is an agent skill from iamlukethedev/Herald-OS.
When should I use Diagnose Crash?
Diagnose Crash fits situations like: tasks that involve Mobile testing and debugging.
How do I install Diagnose Crash in Claude Code?
Run `npx skills add iamlukethedev/Herald-OS --skill diagnose-crash -a claude-code`. Or copy the skill folder (plugins/herald-os-bridge/skills/diagnose-crash in iamlukethedev/Herald-OS) into .claude/skills/diagnose-crash in your project. Claude Code loads it when a task matches its description.
How do I install Diagnose Crash in Codex?
Run `npx skills add iamlukethedev/Herald-OS --skill diagnose-crash -a codex`. Or copy the skill folder (plugins/herald-os-bridge/skills/diagnose-crash in iamlukethedev/Herald-OS) into .agents/skills/diagnose-crash in your project. Codex loads it when a task matches its description.
Can I use Diagnose Crash 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 iamlukethedev/Herald-OS --skill diagnose-crash -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/diagnose-crash, .gemini/skills/diagnose-crash, .github/skills/diagnose-crash and .opencode/skills/diagnose-crash in your project.
What does Diagnose Crash need to run?
SKILL.md names no scripts, command-line tools or credentials: Diagnose Crash is instructions for the agent only.
Does Diagnose Crash 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 Diagnose Crash 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 Diagnose Crash use?
Diagnose Crash is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does Diagnose Crash use?
About 964 tokens (SKILL.md is roughly 3.9k 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 Diagnose Crash?
Skills that share tags, products or a category with Diagnose Crash: Maui AI Debugging (Redth/Maui.Gtk, 101 stars), Engine Whats New (flutter/flutter, 180k stars), Orca iOS Simulator Control (stablyai/orca, 89k stars) and Apple Crash Log .NET Symbolication (dotnet/skills, 5.6k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Diagnose Crash?
iamlukethedev (a GitHub user) maintains it in iamlukethedev/Herald-OS, which has 408 GitHub stars. The repository holds 8 skills in this directory. The repository was last updated on October 10, 2026.
Source: iamlukethedev/Herald-OS on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.