comp-scout-notify

Generate and send dark-mode HTML email digests of open competitions via SMTP.

Updated Dec 9, 2025
One-click install
npx skills add https://github.com/discreteds/competition-scout --skill comp-scout-notify
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: comp-scout-notify
Source: https://github.com/discreteds/competition-scout/tree/main/skills/comp-scout-notify
Command: npx skills add https://github.com/discreteds/competition-scout --skill comp-scout-notify

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill formats open-competition details, strategy insights, and draft entries into a beautiful HTML digest and sends it to multiple recipients. It supports dark mode, highlights closing soon competitions, and provides previews.

Core Features & Use Cases

  • HTML digest generation: Build a polished email digest from issue data and comments.
  • Dark mode support: Email adapts to recipient's theme.
  • Recipient management: Sends to multiple addresses with configurable From and To fields.
  • Preview & JSON exports: Preview HTML/TXT/JSON digest before sending.

Quick Start

  • Preview: python skills/comp-scout-notify/notifier.py preview
  • Send: python skills/comp-scout-notify/notifier.py send
  • Output JSON digest: python skills/comp-scout-notify/notifier.py json

Frequently Asked Questions about comp-scout-notify

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

FAQPage Schema
How do I automate sending HTML email digests of GitHub competition issues?

This Skill automates HTML digest generation and SMTP delivery by querying GitHub competition issues, extracting details and comments, formatting a dark-mode email, and sending to configured recipients. Use the notifier.py send command after setting TARGET_REPO and SMTP credentials.

Can I preview an HTML email digest before sending it?

Yes. Run python notifier.py preview to view the formatted HTML digest in your browser or terminal before delivery, allowing you to verify content, styling, and highlights for closing-soon competitions.

What do I need to set up to send competition digests via SMTP?

You need GitHub CLI authentication, SMTP service credentials, a TARGET_REPO configuration pointing to your competition issues repository, and Python to run notifier.py. The Skill handles formatting and delivery once these prerequisites are in place.

Does this Skill support dark mode for email recipients?

Yes. The HTML digest adapts to the recipient's email client theme preference, rendering in dark mode when enabled and providing consistent readability across light and dark backgrounds.

Can I export competition data as JSON instead of sending email?

Yes. Run python notifier.py json to output the parsed competition digest as JSON, enabling downstream processing, integration with other tools, or custom formatting without email delivery.

How does the Skill identify competitions closing soon in the digest?

The Skill parses GitHub issue bodies and comments to extract competition details and closing dates, then highlights entries with imminent deadlines in the formatted HTML digest to prioritize attention on time-sensitive opportunities.