Agent skill · software engineering · jeremylongshore
granola-debug-bundle
Create diagnostic bundles for Granola support requests.
Why this skill is useful
Adds executable scripts for collecting diagnostic information specific to Granola, which the AI wouldn't generate on its own.
What it needs
Requires granola installed locally. About 4k tokens when loaded. Last updated 2026-08-07. 2,604 stars on the source repository.
What this skill does
Granola Debug Bundle Current State !swvers 2>/dev/null uname -a !defaults read /Applications/Granola.app/Contents/Info.plist CFBundleShortVersionString 2>/dev/null echo 'Granola version: check Menu > About' Overview Collect diagnostic information for Granola support. Produces a zip bundle with system info, audio configuration, network connectivity, and app state — without exposing meeting content, transcripts, or API keys. Prerequisites Terminal access (macOS Terminal or Windows PowerShell) Granola installed (even if malfunctioning) Internet access for network diagnostics Instructions Step 1 — Create Debug Directory Step 2 — Collect System Information macOS: Windows (PowerShell): Step 3 — Check Permissions (macOS) Step 4 — Network Diagnostics Step 5 — Collect Cache Metadata (Not Content) Step 6 — Package and Submit Self-Diagnosis Checklist Run through this before contacting support: [ ] Granola is updated to the latest version (Check for updates in menu) [ ] Internet connection is stable (can load granola.ai in browser) [ ] Microphone permission is granted [ ] Screen & System Audio Recording permission is granted (macOS) [ ] Correct audio input device is selected in System Settings [ ] No conflicting virtual audio software (Loopback, BlackHole, etc.) [ ] Calendar is connected and syncing (check Settings > Calendar) [ ] Sufficient disk space (> 500 MB free) [ ] status.granola.ai shows no active incidents Privacy: What the Bundle Does NOT Include Meeting transcripts or notes content Personal calendar event details API keys or authentication tokens Audio recordings Contact/attendee information Output Zip file on Desktop containing system, audio, network, and app diagnostics Ready for submission to Granola support at help@granola.ai Self-diagnosis checklist completed before escalation Error Handling Error Cause Fix ------- ------- ----- Permission denied on TCC database macOS 14+ security Use manual permission verification instead Network test fails Firewall or proxy Ch …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills jeremylongshore/granola-debug-bundle--92abfd