--- name: steam description: Browse, filter, and discover games in a Steam library. Filter by playtime, reviews, Steam Deck compatibility, genres, and tags. Use when user asks about their Steam games, what to play, game recommendations, or Steam Deck compatible games. homepage: https://github.com/mjrussell/steam-cli metadata: clawdbot: emoji: "🎮" requires: bins: ["steam"] env: ["STEAM_API_KEY"] --- # Steam Games CLI CLI for browsing and discovering games in your Steam library. Filter by playtime, reviews, Deck compatibility, genres, and tags. ## Installation ```bash npm install -g steam-games-cli ``` ## Setup 1. Get a Steam Web API key from https://steamcommunity.com/dev/apikey 2. Configure the CLI: ```bash steam config set-key YOUR_API_KEY steam config set-user YOUR_STEAM_ID ``` ## Commands ### Profile ```bash steam whoami # Profile info and library stats steam whoami --json ``` ### Library ```bash steam library # List all games steam library --limit 10 # Limit results steam library --json # JSON output for scripting ``` ### Tags & Genres (Instant) ```bash steam tags # List all 440+ Steam tags steam tags --json steam genres # List all genres steam genres --json ``` ## Filtering Options ### Playtime ```bash steam library --unplayed # Never played steam library --min-hours 10 # At least 10 hours steam library --max-hours 5 # Less than 5 hours steam library --deck # Played on Steam Deck ``` ### Reviews (1-9 scale) ```bash steam library --reviews very-positive # Exact category steam library --min-reviews 7 # Score 7+ (Positive and above) steam library --show-reviews # Show review column ``` **Categories:** overwhelmingly-positive (9), very-positive (8), positive (7), mostly-positive (6), mixed (5), mostly-negative (4), negative (3), very-negative (2), overwhelmingly-negative (1) ### Steam Deck Compatibility ```bash steam library --deck-compat verified # Verified only steam library --deck-compat playable # Playable only steam library --deck-compat ok # Verified OR Playable steam library --show-compat # Show Deck column ``` ### Tags & Genres ```bash steam library --tag "Roguelike" # Filter by tag steam library --genre "Strategy" # Filter by genre steam library --show-tags # Show tags column ``` ### Sorting ```bash steam library --sort name # Alphabetical (default) steam library --sort playtime # Most played first steam library --sort deck # Most Deck playtime first steam library --sort reviews # Best reviewed first steam library --sort compat # Best Deck compat first ``` ## AI Agent Workflow The CLI is optimized for AI agents with stream fusion and early termination. ### Step 1: Discover available tags/genres (instant) ```bash steam tags --json steam genres --json ``` ### Step 2: Filter library with combined criteria ```bash # Unplayed Deck Verified roguelikes with good reviews steam library --unplayed --deck-compat verified --tag "Roguelike" --min-reviews 7 --limit 10 --json # Well-reviewed strategy games under 5 hours steam library --max-hours 5 --genre "Strategy" --min-reviews 8 --limit 5 --json # Trading games playable on Deck steam library --tag "Trading" --deck-compat ok --limit 10 --json ``` ### Performance Notes - Local filters (playtime, unplayed) apply first - instant - Remote filters (reviews, deck compat, tags) fetch in parallel per game - Early termination: stops when limit is reached - Use local filters first to minimize API calls ## Usage Examples **User: "What should I play on my Steam Deck?"** ```bash steam library --deck-compat verified --min-reviews 7 --sort playtime --limit 10 ``` **User: "What roguelikes do I have?"** ```bash steam library --tag "Roguelike" --show-tags --limit 20 ``` **User: "What unplayed games are highly rated?"** ```bash steam library --unplayed --min-reviews 8 --sort reviews --limit 10 --show-reviews ``` **User: "How many games do I have?"** ```bash steam whoami ``` **User: "What strategy games work on Deck?"** ```bash steam library --genre "Strategy" --deck-compat ok --show-compat --limit 15 ``` **User: "What tags are available?"** ```bash steam tags --json ``` ## Output Formats - Default: Colored table - `--plain`: Plain text list - `--json`: JSON for scripting/AI agents --- Source attribution: kbarbel640-del Original project: https://github.com/kbarbel640-del/skills/blob/e7e336ac628c3e3bd771aff1aaa469c93778f94a/skills/mjrussell/steam/SKILL.md License: MIT License information: https://opensource.org/license/mit Original upstream instructions; downloaded from Dave AI. ## Upstream license notice MIT License Copyright (c) 2026 clawdbot Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. # Dave AI resource metadata Creator / publisher: kbarbel640-del Original project: https://github.com/kbarbel640-del/skills/blob/e7e336ac628c3e3bd771aff1aaa469c93778f94a/skills/mjrussell/steam/SKILL.md Attribution basis: Source repository record Fields of work: Design, Development & Engineering, Marketing Roles: Content Marketer, Game Developer, UX Designer Specialties: API Tools: Steam Country applicability: Country not specified Classification basis: Source catalog labels Instruction SHA-256: 0396e8d5f9e4fc0dbd11ec29ed0dc573adfebd19e841ac66a149c60c05ca7a24