# Send Sports Game Light Tracker to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "game-light-tracker",
    "name": "Sports Game Light Tracker",
    "source": "tencent",
    "type": "skill",
    "category": "AI 智能",
    "sourceUrl": "https://clawhub.ai/0xadamsu/game-light-tracker",
    "canonicalUrl": "https://clawhub.ai/0xadamsu/game-light-tracker",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/game-light-tracker",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=game-light-tracker",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "game-light-tracker",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-03T21:36:00.276Z",
      "expiresAt": "2026-05-10T21:36:00.276Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=game-light-tracker",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=game-light-tracker",
        "contentDisposition": "attachment; filename=\"game-light-tracker-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "game-light-tracker"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/game-light-tracker"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/game-light-tracker",
    "downloadUrl": "https://openagent3.xyz/downloads/game-light-tracker",
    "agentUrl": "https://openagent3.xyz/skills/game-light-tracker/agent",
    "manifestUrl": "https://openagent3.xyz/skills/game-light-tracker/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/game-light-tracker/agent.md"
  }
}
```
## Documentation

### Game Light Tracker

Automatically sync your Hue lights with live sports scores. When the lead changes, your lights change color to match the leading team.

### Quick Start

Basic usage:

Track the [Team A] vs [Team B] game and change my [light name] to [color1] when [Team A] leads and [color2] when [Team B] leads

Examples:

"Track the Rams vs Seahawks game and change my backlight to blue when Rams lead, green when Seahawks lead" (NFL)
"Monitor the Lakers vs Celtics game, purple for Lakers, green for Celtics" (NBA)
"Watch the Rangers vs Devils game - blue for Rangers, red for Devils" (NHL)
"Track the Yankees vs Red Sox game, make my living room light blue for Yankees, red for Red Sox" (MLB)

### How It Works

Fetches live scores from ESPN API every 20 seconds
Detects lead changes
Changes specified Hue light color via Home Assistant
Includes auto-restart keeper to prevent timeouts
Optional: Adds third color for tied games

### Setup Requirements

Home Assistant with Hue lights configured
Home Assistant API token (stored in .homeassistant-config.json)
Light entity ID from Home Assistant

### game-tracker.ps1

Main monitoring script that tracks a specific game and updates lights.

Usage:

.\\game-tracker.ps1 -Sport "nfl" -Team1 "LAR" -Team2 "SEA" -Light "light.backlight" -Color1 "0,0,255" -Color2 "0,100,0" [-TiedColor "255,0,0"]

Parameters:

-Sport: "nfl", "nba", "nhl", or "mlb"
-Team1: First team abbreviation
-Team2: Second team abbreviation
-Light: Home Assistant light entity ID
-Color1: RGB color for Team1 (comma-separated, e.g., "0,0,255" for blue)
-Color2: RGB color for Team2 (comma-separated, e.g., "0,100,0" for dark green)
-TiedColor: (Optional) RGB color when game is tied

### keeper.ps1

Auto-restart supervisor that prevents 30-minute timeout crashes.

Usage:

.\\keeper.ps1 -TrackerScript "game-tracker.ps1" -RestartInterval 25

Parameters:

-TrackerScript: Path to the game-tracker.ps1 script
-RestartInterval: Minutes between restarts (default: 25)

### Common Team Abbreviations

NFL:

Rams: LAR, Seahawks: SEA, Chiefs: KC, Bills: BUF, Patriots: NE
Cowboys: DAL, Eagles: PHI, 49ers: SF, Packers: GB, Bears: CHI
[Full list: https://www.espn.com/nfl/teams]

NBA:

Lakers: LAL, Celtics: BOS, Warriors: GS, Knicks: NY, Bulls: CHI
Heat: MIA, Nets: BKN, 76ers: PHI, Bucks: MIL, Mavericks: DAL
Nuggets: DEN, Suns: PHX, Clippers: LAC, Raptors: TOR
[Full list: https://www.espn.com/nba/teams]

NHL:

Rangers: NYR, Devils: NJ, Bruins: BOS, Maple Leafs: TOR, Canadiens: MTL
Penguins: PIT, Capitals: WSH, Flyers: PHI, Lightning: TB, Panthers: FLA
Red Wings: DET, Blackhawks: CHI, Avalanche: COL, Golden Knights: VGK
[Full list: https://www.espn.com/nhl/teams]

MLB:

Yankees: NYY, Red Sox: BOS, Dodgers: LAD, Giants: SF, Mets: NYM
Cubs: CHC, Cardinals: STL, Astros: HOU, Braves: ATL, Phillies: PHI
[Full list: https://www.espn.com/mlb/teams]

### Common RGB Colors

Blue: 0,0,255
Red: 255,0,0
Green: 0,255,0
Dark Green: 0,100,0
Orange: 255,165,0
Purple: 128,0,128
Yellow: 255,255,0
White: 255,255,255

### Workflow

When user requests game tracking:

Identify sport and teams:

Extract sport (NFL/NBA/NHL/MLB)
Get team abbreviations from user or look up from team names



Get light and color preferences:

Ask for light entity ID (or read from Home Assistant config)
Get desired RGB colors for each team
Optional: Ask if they want a tied-game color



Load Home Assistant config:
$config = Get-Content ".homeassistant-config.json" | ConvertFrom-Json
$token = $config.token
$url = $config.url



Start game tracker:
.\\scripts\\game-tracker.ps1 -Sport "nfl" -Team1 "LAR" -Team2 "SEA" -Light "light.backlight" -Color1 "0,0,255" -Color2 "0,100,0" -TiedColor "255,0,0"



Start keeper for auto-restart:
Start-Process powershell -ArgumentList "-File keeper.ps1 -TrackerScript 'game-tracker.ps1'" -WindowStyle Hidden



Confirm to user:

Tell them monitoring is active
Show current score if available
Explain color scheme
Tell them how to stop it

### Stopping the Tracker

To stop monitoring:

Get-Process powershell | Where-Object { $_.CommandLine -like "*game-tracker.ps1*" -or $_.CommandLine -like "*keeper.ps1*" } | Stop-Process -Force

### Troubleshooting

Light not changing:

Verify Home Assistant token is valid
Check light entity ID is correct
Ensure Home Assistant is accessible at the configured URL

Script crashes:

Keeper should auto-restart it
Check ESPN API is accessible
Verify team abbreviations are correct

Wrong team colors:

Double-check RGB values (must be 0-255, comma-separated)
Ensure colors are assigned to correct teams
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: 0xadamsu
- Version: 1.0.0
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-05-03T21:36:00.276Z
- Expires at: 2026-05-10T21:36:00.276Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/game-light-tracker)
- [Send to Agent page](https://openagent3.xyz/skills/game-light-tracker/agent)
- [JSON manifest](https://openagent3.xyz/skills/game-light-tracker/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/game-light-tracker/agent.md)
- [Download page](https://openagent3.xyz/downloads/game-light-tracker)