Stats
Actions
Tags
From granola-pack
Diagnoses and fixes common Granola errors: audio capture failures, transcription issues, calendar sync problems, integrations. macOS/Windows-specific steps with bash diagnostics.
How this skill is triggered — by the user, by Claude, or both
Slash command
/granola-pack:granola-common-errorsThis skill is limited to the following tools:
The summary Claude sees in its skill listing — used to decide when to auto-load this skill
Diagnose and fix the most common Granola issues. Each error includes platform-specific symptoms, root causes, and step-by-step remediation. Granola captures audio from your device's system audio output (not via meeting platform APIs), so most issues trace back to audio permissions or device configuration.
Diagnose and fix the most common Granola issues. Each error includes platform-specific symptoms, root causes, and step-by-step remediation. Granola captures audio from your device's system audio output (not via meeting platform APIs), so most issues trace back to audio permissions or device configuration.
# Is Granola running?
pgrep -l Granola
# What version?
defaults read /Applications/Granola.app/Contents/Info.plist CFBundleShortVersionString 2>/dev/null
# Audio devices available
system_profiler SPAudioDataType 2>/dev/null | grep -A2 "Default Input"
Root cause: Granola cannot hear system audio. On macOS, this is almost always a permissions issue.
macOS fix:
# Nuclear option — reset Core Audio if devices are confused
sudo killall coreaudiod
# coreaudiod restarts automatically
Windows fix:
Root cause: Granola stops transcription when it detects no new audio for ~15 minutes, or when the computer sleeps.
Fix:
| Cause | Fix |
|---|---|
| Background noise | Use noise-cancelling headset or quiet room |
| Echo/reverb | Smaller room, soft furnishings |
| Crosstalk (multiple speakers) | One person speaks at a time |
| Low mic volume | Position mic within 12 inches, check input levels |
| Non-English accents | Granola accuracy varies — speak clearly, slower |
Symptoms: Granola doesn't show the floating notepad when you join a call.
Checklist:
Fix:
/invite @Granola# Force quit and restart
pkill -9 Granola
open -a Granola
# Clear caches if crashes persist
rm -rf ~/Library/Caches/Granola
# Clear preferences (you'll need to re-authenticate)
defaults delete ai.granola.app 2>/dev/null
rm -rf ~/Library/Caches/Granola
# Reinstall
brew reinstall --cask granola
| Symptom | Most Likely Cause | First Fix |
|---|---|---|
| No transcript | Missing Screen & System Audio permission | Grant permission, restart Granola |
| Transcript stops mid-meeting | Computer sleep or Bluetooth dropout | Keep awake, try wired audio |
| Meeting not detected | No video link in calendar event | Add conferencing link or manually start |
| Slack post missing | Bot not in channel | /invite @Granola |
| HubSpot sync fails | Contact doesn't exist | Create contact in HubSpot first |
| App crashes | Corrupted cache | Delete ~/Library/Caches/Granola |
Proceed to granola-debug-bundle for creating comprehensive diagnostic reports.
npx claudepluginhub jeremylongshore/claude-code-plugins-plus-skills --plugin granola-packProvides triage, remediation, and escalation procedures for Granola incidents including recording failures, transcription stops, sync issues, and outages. Includes bash/curl status checks.
Creates, edits, and optimizes skills for Claude Code, including drafting, evaluating with test prompts, iterating on performance, and improving skill descriptions for better triggering accuracy.