github-notification-cleanup

Filter GitHub notifications to keep open reviewer Pull Requests and archive others.

35|3|Updated Mar 15, 2026
One-click install
npx skills add https://github.com/lauvsong/claude-soul --skill github-notification-cleanup
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: github-notification-cleanup
Source: https://github.com/lauvsong/claude-soul/tree/main/scheduled-tasks/github-notification-cleanup
Command: npx skills add https://github.com/lauvsong/claude-soul --skill github-notification-cleanup

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps you declutter your GitHub notification inbox by retaining only open Pull Requests where you are a reviewer, and archiving the rest as done to reduce distraction.

Core Features & Use Cases

  • Filter notifications to identify PRs that require your review; bulk archive non-critical items using GraphQL to mark as DONE.
  • Preserve keepers per repository so you can revisit reviews later; restore inbox items selectively if needed.
  • Applicable to multi-repo teams and busy developers who need to focus on actionable PRs without losing visibility into remaining alerts.

Quick Start

Run the GitHub CLI to filter notifications and bulk archive all except PRs where you are a reviewer, restoring keepers as needed.

Frequently Asked Questions about github-notification-cleanup

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I filter GitHub notifications to only show pull requests needing my review?

To filter GitHub notifications for pull requests needing your review, this skill identifies open PRs where you are a reviewer and marks all other notifications as DONE using GraphQL mutations, ensuring only actionable PRs remain visible in your inbox.

Can I bulk archive GitHub notifications across multiple repositories while preserving specific PR alerts?

You can bulk archive GitHub notifications across multiple repositories while preserving specific PR alerts by using this skill to mark non-critical notifications as DONE, while safeguards prevent the loss of PRs requiring your review.

Do I need the gh CLI to automate cleaning up GitHub notification inboxes?

Yes, you need the gh CLI to automate cleaning up GitHub notification inboxes, as this skill requires gh CLI access to execute GraphQL mutations that mark notifications as DONE or UNREAD.

What is the best way to manage a cluttered multi-repo GitHub notification inbox?

The best way to manage a cluttered multi-repo GitHub notification inbox is to automate filtering, archiving non-critical alerts as DONE while retaining open PRs where you are a reviewer to reduce distraction and maintain focus.

Can I restore GitHub notifications that were archived as done by mistake?

Yes, you can restore GitHub notifications archived by mistake because the skill includes functionality to selectively restore inbox items by marking them UNREAD as needed after the bulk archive process.

Are there limitations to automating GitHub notification cleanup with GraphQL?

A limitation of automating GitHub notification cleanup with GraphQL is that it requires gh CLI access and careful configuration, although built-in safeguards exist to prevent the loss of keeper PRs during the bulk archiving process.