squid-perflisted
Install: claude install-skill subsquid-labs/skills
# Squid performance comparison
Compare sync-time performance across one or more Squid SDK deployments. Produces a self-contained HTML report and a Markdown summary in the current working directory.
**Skill dir:** Resolve the directory containing this `SKILL.md` once and use its absolute path as `<skill-dir>`. Do not assume a Claude-specific installation path.
**Output dir:** `./squid-perf-output/` (CWD-relative; created if missing)
---
## Locked-in design (do not re-litigate)
These are settled — don't ask the user again unless they change something.
- **Comparison unit:** per-service (e.g., compare `settlement-arbitrum` in deployment A vs B independently of other services). Services present in every compared deployment go in comparison tables; services present in only some go in a "solo metrics" section with a warning.
- **Sync time metric:** report **wall-clock elapsed** (headline), **active processing time** (excludes gaps > 120s — configurable via `--downtime-threshold`), and **downtime** (wall − active). All three per breakpoint. If a restart occurs, measure the final uninterrupted processor segment and report the full restart count separately.
- **Block alignment:** assume all compared indexers cover the same block ranges (user's stated assumption). Use relative-from-first-log per deployment. If detected ranges diverge noticeably across deployments for a given service, emit a loud warning in the summary but still render.
- **Tier of metrics extracted:**
- Tier 1