# Spawn

> Refresh icons and metadata/stats for agents and cloud providers in `manifest.json`. Use when this capability is needed.

- Skill: `tomevault-io/spawn` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/spawn`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/spawn/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: DevOps & Infra
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/spawn

---

# 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:

```bash
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).

---
> Source: [OpenRouterLabs/spawn](https://github.com/OpenRouterLabs/spawn) — distributed by [TomeVault](https://tomevault.io).
<!-- tomevault:4.0:skill_md:2026-06-18 -->