agent-notifications — Claude Code skill: alerts and setup
The agent-notifications Claude Code skill sends desktop alerts during an agent’s work. It acts on user questions, blockers, and meaningful milestones.
GPL-3.0 ★ 835 updated 2026-11-16
npx skills add 777genius/agent-notifications --skill agent-notifications -a claude-codeWhat agent-notifications does
The skill calls Agent Notifications plugin tools to send an alert while work is underway. It uses attention for a request that needs a reply, progress for an intermediate milestone, and info for an informational update.
It searches for notify and notification_status before treating either tool as unavailable, then checks the notification status. It avoids duplicating completion hooks and native approval prompts in Codex Desktop. The plugin and notification permissions must be configured first.
What it helps with
- alert the user when a blocker needs their input
- ask a question while an agent is working
- send an update about an intermediate milestone
Example prompts for the agent
- Send me a desktop alert when you need my answer.
- Notify me if work pauses because of a blocker.
- Send an alert when you reach an important milestone.
How to install agent-notifications
1Skills CLI (Vercel)
npx skills add 777genius/agent-notifications --skill agent-notifications -a claude-code2Manually: put the files in place
~/.claude/skills/agent-notifications/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/agent-notifications/
1Skills CLI (Vercel)
npx skills add 777genius/agent-notifications --skill agent-notifications -a codex2Manually: put the files in place
.agents/skills/agent-notifications/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add 777genius/agent-notifications --skill agent-notifications -a cursor2Manually: put the files in place
.cursor/skills/agent-notifications/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install 777genius/agent-notifications skills/agent-notifications2Manually: put the files in place
.github/skills/agent-notifications/SKILL.md1Skills CLI (Vercel)
npx skills add 777genius/agent-notifications --skill agent-notifications -a gemini-cli2Platform CLI
gemini skills install https://github.com/777genius/agent-notifications --path skills/agent-notificationsManually: put the files in place
.devin/skills/agent-notifications/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add 777genius/agent-notifications --skill agent-notifications -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about agent-notifications
How do I install agent-notifications in Claude Code?
Run npx skills add 777genius/agent-notifications --skill agent-notifications -a claude-code. The skill file is at ~/.claude/skills/agent-notifications/SKILL.md.
What does agent-notifications do?
It discovers the Agent Notifications plugin tools and sends alerts for questions, blockers, or intermediate results. It selects a notification category based on the event.
What does agent-notifications need to work?
The Agent Notifications plugin must be installed and configured, including its notification permissions.