Skill

bug-catcher

Install or invoke the Bug Catcher — a one-keystroke KDE Plasma utility that captures a system bug while it's still fresh in the logs and immediately launches Claude to diagnose and fix it. Use when the user wants quick on-the-spot Linux/system bug capture (GPU freezes, audio dropouts, crashes, OOM, USB issues, network blips, recurring bugs), or asks to install a hotkey for capturing system issues.

npx claudepluginhub danielrosehill/claude-code-plugins --plugin debugging

Tool Access

This skill is limited to using the following tools:

Bash(cp *)Bash(chmod *)Bash(mkdir *)Bash(update-desktop-database *)Bash(sed *)ReadEdit

Preview

A one-keystroke KDE Plasma utility that captures system faults while they're fresh in the logs and immediately launches Claude to diagnose and propose fixes. The skill installs two files — a Bash script and an XDG desktop entry — and guides the user through binding them to a custom hotkey.

Supporting Assets

bug-catcher.shclaude-bug-catcher.desktop

SKILL.md

Similar Skills

cache-components

139.3k

Guides Next.js Cache Components and Partial Prerendering (PPR): 'use cache' directives, cacheLife(), cacheTag(), revalidateTag() for caching, invalidation, static/dynamic optimization. Auto-activates on cacheComponents: true.

cache-components

mcp-builder

124.2k

Guides building MCP servers enabling LLMs to interact with external services via tools. Covers best practices, TypeScript/Node (MCP SDK), Python (FastMCP).

9 files

anthropics-skills-13

Stats

Stars1

Forks1

Last CommitApr 30, 2026

Actions

View Source View Plugin View on GitHub View README

Help us improve

Share bugs, ideas, or general feedback.

Bug Catcher

When to use

User asks to "set up bug catcher" or "install bug hotkey"
User wants a quick on-the-spot capture for GPU freezes, audio dropouts, crashes, OOM, USB issues, or network blips
User says "set up quick bug capture" or "I want a hotkey to report system bugs"

Inputs to gather

Desktop environment — confirm whether KDE Plasma (default) or GNOME/other (triggers adaptation)
Preferred hotkey binding — suggest Super+B if not specified
Permission level — confirm user understands the script uses --dangerously-skip-permissions so Claude can act on diagnosis fast

Procedure

1. Determine Desktop Environment and Adaptation

Ask the user which desktop they're running. If KDE Plasma, proceed with kdialog/konsole. If GNOME or other, flag that the script will be adapted to use zenity/gnome-terminal, then proceed.

2. Locate and Prepare Source Files

Inside the skill directory (skills/bug-catcher/), find bug-catcher.sh and claude-bug-catcher.desktop. These files are created by the orchestrator.

3. Create Installation Target Directories

Create ~/.local/bin/ if missing:

mkdir -p ~/.local/bin

4. Adapt Script for Non-KDE Environments

If the user is on GNOME, edit bug-catcher.sh:

Replace kdialog with zenity throughout
Replace konsole with gnome-terminal

Copy the (possibly adapted) script to ~/.local/bin/bug-catcher and make it executable:

cp bug-catcher.sh ~/.local/bin/bug-catcher
chmod +x ~/.local/bin/bug-catcher

5. Rewrite Desktop Entry

Edit claude-bug-catcher.desktop to replace its Exec= line. The original points to the source repo; rewrite it to:

Exec=/home/<user>/.local/bin/bug-catcher

(Alternatively, if the script location differs, use the actual path.)

Copy the rewritten desktop entry:

mkdir -p ~/.local/share/applications/
cp claude-bug-catcher.desktop ~/.local/share/applications/

6. Update Desktop Database

Run:

update-desktop-database ~/.local/share/applications/

7. Guide Hotkey Binding

Instruct the user to:

Open KDE System Settings (or GNOME Settings if adapted).
Navigate to Shortcuts (or Keyboard on GNOME).
Under Custom Shortcuts, add a new entry pointing to /home/<user>/.local/bin/bug-catcher.
Bind it to the preferred hotkey (default: Super+B).
Save and close.

8. Confirm Installation

Ask the user to test the hotkey. When pressed, it should launch a kdialog (or zenity) menu listing common bug categories: GPU Freeze, Audio Dropout, Crash/OOM, USB Issue, Network Blip, Recurring Bug, Custom.

Selecting a category launches claude --dangerously-skip-permissions in a new konsole (or gnome-terminal) with a prompt asking Claude to grep journalctl --since '5 minutes ago' and dmesg for relevant faults and propose/implement fixes.

Output / side effects

bug-catcher.sh copied to ~/.local/bin/bug-catcher (executable)
claude-bug-catcher.desktop copied to ~/.local/share/applications/ with rewritten Exec= path
Desktop database updated
User hotkey bound to the script (manual step; no file changes here)
When invoked, the hotkey presents a menu, then spawns a new terminal with Claude running in diagnostic mode

Safety / constraints

The script uses --dangerously-skip-permissions, allowing Claude to execute shell commands without confirmation during diagnosis. Flag this to the user once at the end of installation and confirm they are comfortable with it.
Only KDE Plasma and GNOME are supported out of the box; other desktop environments require manual script adaptation.
The script greps logs --since '5 minutes ago' — older issues may not appear. Advise the user to invoke the hotkey as soon as a bug is noticed.
Destructive fixes (like force-restarting services or modifying system config) should be reviewed by the user before Claude attempts them; the script should always ask for confirmation before destructive acts.