Skill

gh-notification-summary

Review, summarize, and manage GitHub notifications. Use this skill whenever the user mentions GitHub notifications, unread GitHub activity, open issues on their repos, or wants to catch up on project discussions — even if they don't use the word 'notifications'. Also trigger for /unsub <number>, 'mark all done', 'clear my GitHub inbox', or any request to triage, dismiss, or act on GitHub notifications.

npx claudepluginhub castastrophe/agent-skills

Tool Access

This skill uses the workspace's default tool permissions.

Preview

Fetch unread GitHub notifications, present them in an interactive local dashboard, and execute follow-up actions the user requests.

Supporting Assets

evals/evals.jsonpackage.jsonpyproject.tomlrequirements.txtscripts/__init__.pyscripts/gh_notifications.pyscripts/templates/dashboard.htmltests/test_gh_notifications.pyuv.lock

SKILL.md

Similar Skills

cache-components

139.3k

Guides Next.js Cache Components and Partial Prerendering (PPR) with cacheComponents enabled. Implements 'use cache', cacheLife(), cacheTag(), revalidateTag(), static/dynamic optimization, and cache debugging.

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

Stars0

Forks0

Last CommitApr 10, 2026

Actions

View Source View Plugin View on GitHub View README

Help us improve

Share bugs, ideas, or general feedback.

GitHub Notification Reviewer

Fetch unread GitHub notifications, present them in an interactive local dashboard, and execute follow-up actions the user requests.

Runtime path: Resolve <skill-path> as the directory containing this SKILL.md file. All script paths below are relative to that directory.

Environment requirements

GITHUB_TOKEN set in the environment or a .env file at <skill-path>
GITHUB_REPO (optional) — used as the default repository when the user omits one

CLI

All actions go through a single script with subcommands:

python <skill-path>/scripts/gh_notifications.py <command> [options]

Workflow

Run gh_notifications.py fetch to open the dashboard in the user's browser.
The user reviews their notifications at http://localhost:8000.
Ask whether they want to take any actions — unsubscribe from issues or mark notifications as done.
Execute the appropriate subcommand (see Quick Actions below) and confirm the result.

Launching the dashboard

python <skill-path>/scripts/gh_notifications.py fetch

This fetches all unread notifications via the GitHub API, starts a local HTTP server on port 8000, and opens the dashboard automatically. The dashboard shows each notification as a card with labels, latest comments, and copy-paste quick-action commands.

Quick Actions

Unsubscribe from an issue

When the user says /unsub <number> or asks to unsubscribe from an issue:

python <skill-path>/scripts/gh_notifications.py unsub <number> --repo <owner/repo>

Unsubscribes from the thread and marks the notification as done. If --repo is omitted, GITHUB_REPO is used as the default.

Mark notifications as done

To mark all notifications as done:

python <skill-path>/scripts/gh_notifications.py done

To mark a specific issue as done:

python <skill-path>/scripts/gh_notifications.py done <number> --repo <owner/repo>

Dashboard template

The HTML dashboard is rendered from a Jinja2 template at <skill-path>/scripts/templates/dashboard.html. To customize the dashboard appearance, edit that template directly. The template receives:

repo_name — the repository name string
now — the current UTC datetime
cards — a list of notification dicts, each with title, reason, issue_number, issue_url, labels, comments, etc.

Custom Jinja2 filters available in the template: relative_time, summarize, label_text_color.

Scheduled use

This skill is well-suited for a daily morning routine. When running on a schedule:

Launch the dashboard.
Present the URL to the user.
Ask whether they want to take any actions before wrapping up.