Brought to you by Allons-y Studio

@allons-y/agent-skills skills

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

Folder structure #

Everything in this skill's source directory — scripts, references, and the tests and evals that back it. The installer copies the runtime files into your skills directory; the tests and evals stay in the repo.

gh-notification-summary
|-- bin
|   `-- cli.js
|-- evals
|   `-- evals.json
|-- references
|   `-- development.md
|-- scripts
|   |-- caching.js
|   |-- github.js
|   `-- server.js
|-- templates
|   |-- dashboard.css
|   |-- dashboard.html
|   `-- dashboard.js
|-- tests
|   |-- fixtures
|   |   |-- octokit-mock.js
|   |   `-- octokit-responses.json
|   |-- caching.test.js
|   |-- cli.test.js
|   |-- github.test.js
|   |-- notifications-test-mode.test.js
|   `-- server.test.js
|-- .env.example
|-- CHANGELOG.md
|-- package.json
`-- SKILL.md

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...

Learn more

dreamlight-valley

Games Implementation Tested Live preview

Cooking, gathering, and inventory management for Dreamlight Valley.

Learn more

install-guide-builder

Documentation Implementation Tested Live preview

Generate printable, platform-split developer environment setup guides — install steps side by side per OS, a verification check after every...

Learn more

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...

Learn more