Steam Icon Fixer

Fix missing or generic Steam game desktop icons on Linux by finding the Steam app ID from local launchers and installing replacement artwork into the user's...

Security Scan

The skill's code, instructions, and requested resources align with its stated purpose (repairing Steam icons on Linux); it reads/writes local XDG paths and refreshes the icon cache but does not request unrelated credentials or network access.

Purpose & Capability

Name/description match the code and SKILL.md: the script scans .desktop files, extracts Steam app IDs, writes icon PNGs into the user's icon theme, and optionally refreshes the icon cache. No unrelated services or credentials are requested.

Instruction Scope

SKILL.md instructs running the bundled script with clear flags and default directories. The runtime instructions and the script act only on local files (XDG applications/icons dirs) and do not instruct reading unrelated system state or sending data externally.

Install Mechanism

No install spec — the skill is instruction + bundled script. Nothing is downloaded at install time. The only runtime dependency is Pillow (noted in SKILL.md), which is local and expected for image processing.

Credentials

The skill declares no required environment variables or credentials. It does read XDG_DATA_HOME and HOME to locate directories (expected). The only minor mismatch: the script requires Pillow at runtime but the metadata does not declare this dependency explicitly (SKILL.md mentions it).

Persistence & Privilege

always is false and the skill does not request persistent system-wide privileges or modify other skills. It writes icon files to the user's icon theme (a scoped and expected filesystem change).

Assessment

This skill appears to do exactly what it says: scan local .desktop launchers, derive Steam app IDs, generate PNG icon files in your XDG icons directory, and refresh the icon cache. Before running, consider: (1) you may need Pillow (PIL) installed in the environment; (2) the script will read .desktop files under your home (or XDG_DATA_HOME) and will create/modify files under your icons directory — back up any icon theme you care about if concerned; (3) the script invokes system icon-cache tools if present, which run locally; (4) the skill does not contact external servers or request credentials. Only install/use if you trust the skill source or review the included script; otherwise run it in a sandbox or manually inspect/execute the script yourself.

Use this skill to repair Steam launcher icons on Linux desktops.

Core workflow

1. Prefer the user's explicit inputs when available.
   • downloaded image path
   • game name
   • Steam app ID
   • specific .desktop file
2. Otherwise infer the common local locations.
   • launcher dir: ${XDG_DATA_HOME:-~/.local/share}/applications
   • icon dir: ${XDG_DATA_HOME:-~/.local/share}/icons/hicolor
3. Discover the app ID from the launcher metadata.
   • look for Icon=steam_icon_<id>
   • look for Exec=...steam://rungameid/<id>
   • if needed, search local launchers by game name
4. Run the bundled installer script.
5. Refresh the icon cache if the script does not do it automatically.

Commands

Scan local Steam launchers for missing icons:

python3 scripts/steam_icon_fixer.py scan

Install an image with an explicit app ID:

python3 scripts/steam_icon_fixer.py install \
  --image /path/to/image.png \
  --app-id 1086940

Install an image by matching a game name:

python3 scripts/steam_icon_fixer.py install \
  --image /path/to/image.png \
  --game "Baldur's Gate 3"

Install using a specific desktop file:

python3 scripts/steam_icon_fixer.py install \
  --image /path/to/image.png \
  --desktop-file ~/.local/share/applications/Baldur's\ Gate\ 3.desktop

Use explicit directories when the machine is nonstandard:

python3 scripts/steam_icon_fixer.py install \
  --image /path/to/image.png \
  --game "DOOM: The Dark Ages" \
  --desktop-dir /custom/applications \
  --icons-dir /custom/icons/hicolor

Bundled resources

• scripts/steam_icon_fixer.py: deterministic installer/scanner for Steam launcher icons.
• references/: add launcher or icon-theme notes here if the workflow needs machine-specific guidance.

Notes

• The script should generate standard icon sizes and keep Steam's steam_icon_<appid>.png naming.
• For .ico inputs, Pillow may be required.
• If GNOME or another dock keeps the old icon, unpin and re-pin the launcher after the cache refresh.