← Back to Skills Marketplace
terrycarter1985

GOG Stale Games Cleanup

by terrycarter1985 · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ✓ Security Clean
49
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install gog-stale-games-cleanup
Description
Scan your GOG library for installed games not played in 30+ days, email the list, and add Apple Reminders for each. One-command game cleanup workflow.
README (SKILL.md)

GOG Stale Games Cleanup

Find installed GOG games you haven't played in 30+ days, email yourself a summary, and create Apple Reminders so you can decide whether to uninstall.

When to Use

  • User says "clean up my GOG library", "stale games", "games I haven't played", "uninstall reminder"
  • Running a periodic game-library audit
  • Triggered by cron for monthly cleanup reminders

Quick Start

bash scripts/sweep.sh \
  --library /path/to/gog_library.json \
  --days 30 \
  --email personal \
  --reminders-list Gaming

Parameters

Flag Default Description
--library config/gog_library.json Path to GOG library JSON
--days 30 Stale threshold in days
--email personal Himalaya account name for sending
--reminders-list Gaming Apple Reminders list name
--dry-run off Print actions without sending email or creating reminders

What It Does

  1. Reads your GOG library JSON
  2. Filters for installed: true games whose last_played is older than the threshold (or null)
  3. Sends an HTML email via himalaya with the stale game list
  4. Adds one Apple Reminder per stale game to the specified list

Output Example

🧹 GOG Stale Games Sweep — 2026-05-12
  Found 2 stale games (>30 days since last play):

  • Stardew Valley — last played 2026-03-28
  • Cyberpunk 2077 — never played

  ✉️  Email sent to [email protected]
  📝 2 reminders added to "Gaming" list

Configuration

GOG Library JSON

See references/gog_library_schema.json for the expected format. Each game needs:

  • name (string)
  • installed (boolean)
  • last_played (ISO 8601 datetime or null)

Himalaya

See references/himalaya.toml.example. The script uses himalaya template send on the account specified by --email.

Apple Reminders

The list specified by --reminders-list is created if it doesn't exist (remindctl list \x3Cname> --create).

Cron Integration

Run monthly:

# Add via OpenClaw cron — monthly on the 1st at 10:00
openclaw cron add --name "gog-stale-sweep" \
  --schedule "0 10 1 * *" \
  --command "bash /path/to/scripts/sweep.sh --library /path/to/gog_library.json"

Or use the agent's cron tool with a systemEvent payload that triggers this skill.

Usage Guidance
Before installing or running, review scripts/sweep.sh, run it once with --dry-run, confirm the GOG library path, himalaya email account, recipient, and Reminders list, and only enable the cron example if you want recurring automated reports.
Capability Analysis
Type: OpenClaw Skill Name: gog-stale-games-cleanup Version: 1.0.0 The skill bundle provides a legitimate utility for managing a GOG game library by identifying games not played recently and notifying the user via email and Apple Reminders. The core logic in `scripts/sweep.sh` uses standard tools like `jq` for data processing, `himalaya` for email delivery, and `remindctl` for macOS reminders, with behavior that aligns strictly with the documentation in `SKILL.md`.
Capability Assessment
Purpose & Capability
The behavior is coherent with the stated purpose: it reads a GOG library JSON, identifies stale installed games, sends a report, and creates reminders rather than uninstalling games.
Instruction Scope
The quick-start command is user-directed and includes a dry-run option, but the normal path sends email and creates reminders without an additional confirmation step.
Install Mechanism
There is no install script or package download; the included shell script depends on disclosed local binaries: jq, himalaya, and remindctl.
Credentials
The required email and Apple Reminders integrations are proportionate to the purpose, though users should verify the configured accounts and reminder list before running.
Persistence & Privilege
No hidden persistence is present, but the documentation provides optional cron setup that would make the workflow run repeatedly if the user enables it.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install gog-stale-games-cleanup
  3. After installation, invoke the skill by name or use /gog-stale-games-cleanup
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release: scan installed GOG games not played in 30+ days, email summary, add Apple Reminders
Metadata
Slug gog-stale-games-cleanup
Version 1.0.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is GOG Stale Games Cleanup?

Scan your GOG library for installed games not played in 30+ days, email the list, and add Apple Reminders for each. One-command game cleanup workflow. It is an AI Agent Skill for Claude Code / OpenClaw, with 49 downloads so far.

How do I install GOG Stale Games Cleanup?

Run "/install gog-stale-games-cleanup" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is GOG Stale Games Cleanup free?

Yes, GOG Stale Games Cleanup is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does GOG Stale Games Cleanup support?

GOG Stale Games Cleanup is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created GOG Stale Games Cleanup?

It is built and maintained by terrycarter1985 (@terrycarter1985); the current version is v1.0.0.

💬 Comments