/update-metadata

Update Agent & Cloud Metadata

Refresh icons and metadata/stats for agents and cloud providers in `manifest.json`.

When to use

Run this when:

• An agent or cloud provider's logo changes
• An icon URL breaks (404 or stale redirect)
• A new agent or cloud is added without an icon
• GitHub star counts need refreshing
• Agent repo info changed (license, language)
• You want a full metadata audit
• You need to validate that all source URLs are still reachable

Arguments

• `--agent <id>` — Update only the specified agent (e.g. `--agent openclaw`).
• `--cloud <id>` — Update only the specified cloud (e.g. `--cloud hetzner`).
• `--agents-only` — Only process agents, skip clouds.
• `--clouds-only` — Only process clouds, skip agents.
• `--icons-only` — Only refresh icons, skip GitHub metadata.
• `--stats-only` — Only refresh GitHub stats, skip icon downloads.
• `--validate` — Check all source URLs are reachable without downloading. Exits with code 1 if any are broken.
• `--dry-run` — Print what would change without writing files.

Procedure

Run the update script, passing through any arguments:

bun run .claude/skills/update-metadata/update.ts [arguments]

Fixing broken sources

If `--validate` reports broken URLs (marked with `✗`), fix them by editing the relevant `.sources.json` file:

• **Agent sources**: `assets/agents/.sources.json`
• **Cloud sources**: `assets/clouds/.sources.json`

Each entry maps an id to `{ "url": "...", "ext": "png" }`. Update the `url` to a working icon source (apple-touch-icon, GitHub org avatar, or favicon), then re-run the script without `--validate` to download and update everything.

Review the output, then commit the changed files (`manifest.json`, `.sources.json` files, and any updated icon files).