← Back to Skills Marketplace
terrycarter1985

GOG Stale Games Cleaner

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

GOG Stale Games Cleaner

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

When to Use

  • User wants to clean up their GOG library
  • User asks about stale / unused / forgotten installed games
  • User wants a periodic cleanup reminder workflow
  • Phrases like "stale games", "game cleanup", "haven't played in a while"

When NOT to Use

  • Browsing or searching the GOG catalog → use the gog skill
  • Managing game installs/uninstalls directly → GOG Galaxy client only
  • Scheduling the scan itself → use cron after the skill runs once

Prerequisites

  1. GOG library data — a JSON file at config/gog_library.json in the workspace (exported from GOG Galaxy or manually maintained). Must contain games[] with installed (bool) and last_played (ISO-8601 or null).
  2. Himalaya — CLI email client configured with a personal account (himalaya --version).
  3. remindctl — Apple Reminders CLI (remindctl status). macOS only.
  4. Gaming list — an Apple Reminders list named Gaming (created automatically if missing).

Configuration

All paths are relative to the OpenClaw workspace root unless absolute.

Variable Default Description
GOG_LIBRARY_PATH config/gog_library.json Path to GOG library JSON
STALE_DAYS 30 Days since last play to count as stale
REMINDERS_LIST Gaming Apple Reminders list name
EMAIL_ACCOUNT personal Himalaya account to send from
EMAIL_TO (from account) Recipient email; defaults to account address

Script

The main script is scripts/gog-stale-scan.sh. Run it directly or let the agent invoke it.

# Dry run (print only, no email/reminders)
bash scripts/gog-stale-scan.sh --dry-run

# Full run
bash scripts/gog-stale-scan.sh

# Custom stale threshold
STALE_DAYS=60 bash scripts/gog-stale-scan.sh

What It Does

  1. Reads config/gog_library.json
  2. Filters for installed: true games whose last_played is >30 days ago (or null)
  3. Prints a formatted table to stdout
  4. Sends an HTML email via himalaya to your personal account
  5. Adds one Apple Reminders entry per stale game to the Gaming list with a note: "Consider uninstalling — last played YYYY-MM-DD"

Cron Scheduling (Optional)

After a successful run, schedule it monthly:

0 10 1 * *  # 10 AM on the 1st of each month

Use the cron tool with an agentTurn payload that invokes this skill.

Output Example

🧹 Stale GOG Games (not played in 30+ days)
─────────────────────────────────────────────
  Stardew Valley          last played 2026-03-28
  Baldur's Gate 3         last played 2026-04-01
─────────────────────────────────────────────
2 stale games found. Email sent. 2 reminders added to Gaming.
Usage Guidance
Run the dry-run command first, confirm the GOG library file and email account are correct, and be aware that full runs send an email and create Apple Reminders. If you enable the suggested cron schedule, review it periodically to avoid repeated or duplicate reminders.
Capability Analysis
Type: OpenClaw Skill Name: gog-stale-games Version: 1.0.0 The skill is a legitimate utility designed to help users manage their GOG game library by identifying stale installations and sending reports via email and Apple Reminders. The implementation in `scripts/gog-stale-scan.sh` is well-structured, uses standard tools (`jq`, `himalaya`, `remindctl`), and follows security best practices such as quoting variables and using `set -euo pipefail` to prevent common shell script vulnerabilities. The behavior is entirely consistent with the documentation in `SKILL.md`, and no evidence of malicious intent, data exfiltration, or prompt injection was found.
Capability Assessment
✓ Purpose & Capability
The artifacts coherently implement the stated purpose: read a GOG library JSON file, identify stale installed games, email a report, and add Apple Reminders; the script does not uninstall games directly.
ℹ Instruction Scope
The normal run sends email and creates reminders, while dry-run mode is documented; users should choose dry-run first if they only want a preview.
ℹ Install Mechanism
There is no remote installer or download behavior, but the script has an undeclared runtime dependency on jq in addition to the declared himalaya and remindctl tools.
ℹ Credentials
The skill’s access to a workspace GOG JSON file, local email profile, and Apple Reminders is purpose-aligned, but it handles personal game/library and local path information.
ℹ Persistence & Privilege
Reminders persist after the run, and the documentation suggests optional monthly cron scheduling; this is disclosed and aligned with the cleanup-reminder purpose.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install gog-stale-games
  3. After installation, invoke the skill by name or use /gog-stale-games
  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 report, add Apple Reminders
Metadata
Slug gog-stale-games
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 Cleaner?

Scan your GOG library for installed games not played in 30+ days, email the list, and add reminders to consider uninstalling. One-command cleanup workflow. It is an AI Agent Skill for Claude Code / OpenClaw, with 46 downloads so far.

How do I install GOG Stale Games Cleaner?

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

Is GOG Stale Games Cleaner free?

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

Which platforms does GOG Stale Games Cleaner support?

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

Who created GOG Stale Games Cleaner?

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

More Skills
self-improving agent
Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Clau...
⬇ 463815 · by pskoett
Skill Vetter
Security-first skill vetting for AI agents. Use before installing any skill from ClawdHub, GitHub, or other sources. Checks for red flags, permission scope, and suspicious patterns.
⬇ 259802 · by spclaudehome
Polymarket
Query Polymarket prediction markets. Check odds, find trending markets, search events, track price movements.
⬇ 232503 · by joelchance
Self-Improving + Proactive Agent
Self-reflection + Self-criticism + Self-learning + Self-organizing memory. Agent evaluates its own work, catches mistakes, and improves permanently. Use when...
⬇ 200680 · by ivangdavila
Github
Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries.
⬇ 191345 · by steipete
ontology
Typed knowledge graph for structured agent memory and composable skills. Use when creating/querying entities (Person, Project, Task, Event, Document), linkin...
⬇ 190333 · by oswalpalash

💬 Comments