← 返回 Skills 市场

GOG Stale Games Cleaner

Name: GOG Stale Games Cleaner
Author: terrycarter1985

作者 terrycarter1985 · GitHub ↗ · v1.0.0 · MIT-0

cross-platform ✓ 安全检测通过

总下载

当前安装

版本数

在 OpenClaw 中安装

/install gog-stale-games

功能描述

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.

使用说明 (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

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).
Himalaya — CLI email client configured with a personal account (himalaya --version).
remindctl — Apple Reminders CLI (remindctl status). macOS only.
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

Reads config/gog_library.json
Filters for installed: true games whose last_played is >30 days ago (or null)
Prints a formatted table to stdout
Sends an HTML email via himalaya to your personal account
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.

安全使用建议

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.

功能分析

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.

能力评估

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

如何使用

确保已安装 OpenClaw（本地或 Docker 部署）
在对话框中输入安装命令：/install gog-stale-games
安装完成后，直接呼叫该 Skill 的名称或使用 /gog-stale-games 触发
根据 Skill 的参数说明提供必要输入，即可获得结构化输出

版本历史

v1.0.0

Initial release: scan installed GOG games not played in 30+ days, email report, add Apple Reminders

元数据

Slug gog-stale-games

版本 1.0.0

许可证 MIT-0

累计安装 0

当前安装数 0

历史版本数 1

常见问题