GOG Cleanup Reminder

Scan installed GOG games, find titles inactive for 30+ days, email the list to the configured personal address, and add Apple Reminders in the Gaming list fo...

Security Scan

The skill's code and instructions match its stated purpose (scan a local GOG export, email a summary, and add Apple Reminders) and it does not request unexplained credentials or external endpoints.

Purpose & Capability

Name/description, SKILL.md, and the script are consistent: the script reads a local GOG JSON export, filters installed games not played for N days, sends a summary email via himalaya, and creates Apple Reminders via remindctl. Prerequisite commands (himalaya, remindctl, python3) are appropriate for that functionality.

Instruction Scope

Runtime instructions and the script stay inside the documented scope: they read config/gog_library.json and config/himalaya.toml, build an email body (including install_path), and call himalaya and remindctl. There are no instructions to read unrelated system files, contact unknown external endpoints, or exfiltrate data outside the user's configured email account.

Install Mechanism

There is no install spec — the skill is instruction + script only. No downloads or package installs are performed by the skill itself. Requiring himalaya and remindctl is reasonable for sending mail and creating Reminders.

Credentials

The skill does not request environment variables or credentials, but it reads the himalaya TOML config file (which holds mail credentials) and uses that configuration to send mail. This is proportionate to the stated purpose, but users should be aware that the script will use the local mail account and may include local install paths in the email body (potentially exposing filesystem paths).

Persistence & Privilege

The skill is not marked always:true, does not modify other skills or global agent settings, and does not request persistent platform privileges. Autonomous invocation is allowed by default but is not combined with other concerning flags.

Assessment

This skill appears to do what it says: it reads a local GOG library export and your himalaya config, sends a summary email using your configured himalaya account, and creates Apple Reminders via remindctl. Before installing or running: 1) Inspect config/gog_library.json and config/himalaya.toml to confirm they contain expected data and no unexpected accounts; 2) Run the script with --dry-run and --print-json first to verify the output; 3) Be aware the email body includes install_path values (which can reveal local filesystem locations); 4) Confirm you trust the himalaya and remindctl binaries on your system; 5) Note the provided script file was truncated in the listing—review the complete script in the package before running to ensure no unexpected behavior in the missing portion.

Use this skill when the user wants a repeatable cleanup workflow for their installed GOG library.

What it does

• Reads a GOG library JSON export
• Selects games where:
  • installed == true
  • last_played is at least 30 days ago
• Emails the stale installed-game list to the configured personal email account
• Adds one Apple Reminder per stale game to the Gaming list

Default config inputs

This skill is designed to work with the workspace config files already present in this environment:

• GOG library: config/gog_library.json
• Himalaya mail config: config/himalaya.toml
• Apple Reminders list name: Gaming

Main script

python3 scripts/gog_cleanup_reminder.py --dry-run --print-json

Real run

python3 scripts/gog_cleanup_reminder.py

Common options

python3 scripts/gog_cleanup_reminder.py --days 45
python3 scripts/gog_cleanup_reminder.py --list Gaming
python3 scripts/gog_cleanup_reminder.py --email-account personal
python3 scripts/gog_cleanup_reminder.py --allow-no-play-history
python3 scripts/gog_cleanup_reminder.py --skip-email
python3 scripts/gog_cleanup_reminder.py --skip-reminders

Notes

• himalaya must be installed and able to send mail for the chosen account.
• remindctl must be installed on macOS and authorized to access Apple Reminders.
• The script will create the target reminders list if needed.
• By default, installed games with last_played = null are ignored to avoid noisy reminders. Use --allow-no-play-history if you want those included.

Output behavior

• If no matching games are found, the script exits successfully and reports that there is nothing to clean up.
• On success, it sends exactly one summary email and creates one reminder per matching game.
• --dry-run shows the email body without sending mail or creating reminders.