gh-notification-summary

Review, summarize, and manage GitHub notifications via an interactive local dashboard. Unsubscribe from noisy threads, mark individual notifications or your whole inbox as done, all from a single prompt.

GitHub Implementation Tested Node

Install this skill View source

How to use it #

Once installed, this skill activates automatically when your prompt matches one of its triggers.

Try saying

  • check my GitHub notifications
  • /unsub <number>
  • mark all done
  • clear my GitHub inbox
  • any request to triage, dismiss, or act on GitHub notifications

Install #

Pick the card for your agent harness. The skill payload is identical everywhere — no Claude-specific wiring.

Claude Agent SDK

Vendor with npx

Drop any skill into your agent's SKILL.md directory. No Claude-specific wiring.

npx @allons-y/agent-skills gh-notification-summary --dir ~/.claude/skills

Cursor

Vendor with npx

Cursor reads skill folders from your project. Vendor the skill, then point Cursor at it.

npx @allons-y/agent-skills gh-notification-summary --dir .cursor/skills

Any other harness

Pick your own directory

Aider, OpenCode, or anything that reads SKILL.md directories. Choose your target folder.

npx @allons-y/agent-skills --list
npx @allons-y/agent-skills gh-notification-summary --dir <your-skills-dir>

This skill ships a Node.js implementation — run npm install in the vendored directory once.

Full skill instructions #

This is the SKILL.md the agent reads when the skill activates. View the source on GitHub.

GitHub Notification Reviewer

Fetch, display, and act on unread GitHub notifications via a local dashboard.

Environment

  • GITHUB_TOKEN — required (env or <skill-path>/.env)
  • GITHUB_REPO — optional default for --repo (format: owner/repo)

Commands

All actions invoke the gh-notifications bin (installed by the skill’s package.json).

User intent Command Notes
Open the dashboard gh-notifications fetch [--repo owner/repo] Blocks until Ctrl+C; opens browser at http://localhost:8000. Without --repo or GITHUB_REPO, shows all unread notifications.
Unsubscribe from an issue gh-notifications unsub <number> --repo owner/repo Deletes thread subscription + marks done. --repo falls back to GITHUB_REPO.
Mark one issue done gh-notifications done <number> --repo owner/repo --repo falls back to GITHUB_REPO.
Mark all done gh-notifications done No issue arg = clear inbox.

Workflow

  1. Run gh-notifications fetch and tell the user the dashboard is at http://localhost:8000.
  2. Wait for the user to ask for follow-up actions (unsub, mark done).
  3. Run the matching command from the table. Confirm the result.
  4. When the user is finished, remind them to Ctrl+C the fetch process to free port 8000.

Reference

  • Dashboard template: <skill-path>/templates/dashboard.html (Nunjucks; edit to customize).
  • Development setup and local preview: <skill-path>/references/development.md.

Other skills #

design-system

Design Reference Tested

Build, name, document, and audit UI components with expert ARIA, accessibility, design token, typography, and i18n guidance written by a...

dreamlight-valley

Games Implementation Tested Live preview

Cooking, gathering, and inventory management for Dreamlight Valley.

structured-data

SEO Implementation Tested

Inject or generate schema.org structured data (HTML Microdata or JSON-LD) into web markup, then validate it. Picks the right format per...