squid-perf

Compare Squid SDK deployment sync times from sqd logs into HTML and Markdown reports.

Updated Feb 10, 2026
One-click install
npx skills add https://github.com/subsquid-labs/skills --skill squid-perf
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: squid-perf
Source: https://github.com/subsquid-labs/skills/tree/main/squid-sdk/squid-perf
Command: npx skills add https://github.com/subsquid-labs/skills --skill squid-perf

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires expect, sqd, and includes scripts (resource) components.

What problem does it solve?

Analyzes and compares the sync-time performance of Squid SDK deployments by collecting and interpreting logs across one or more indexers, helping teams identify bottlenecks and validate optimizations.

Core Features & Use Cases

  • Fetches logs via the sqd CLI for one or more deployments and parses per-service progress data.
  • Generates a self-contained HTML report (Chart.js inlined) plus a Markdown summary with wall-clock, active processing, and downtime breakouts at log-spaced breakpoints.
  • Supports both multi-deployment comparisons and single-indexer profiling, with configurable breakpoints and downtime thresholds.
  • Use case: compare two indexers to measure which reaches chain tip faster and which exhibits idle tail in between.

Quick Start

Run /squid-perf with one or more refs to fetch, parse, and render the performance report.

Frequently Asked Questions about squid-perf

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I compare Squid SDK deployment sync times across multiple indexers?▼

Comparing Squid SDK deployment sync times involves fetching logs via the sqd CLI for multiple deployments, parsing per-service progress data, and computing wall-clock elapsed, active processing, and downtime to measure which indexer reaches chain tip faster.

What is the best way to benchmark a single Squid indexer across different environments?▼

Benchmarking a single Squid indexer involves profiling its sync performance across environments by parsing log progress data with configurable breakpoints and downtime thresholds to identify processing bottlenecks and validate optimizations.

How do I generate a performance report for Squid deployment logs?▼

Generating a performance report for Squid deployment logs produces a self-contained HTML report with inlined Chart.js and a Markdown summary, displaying wall-clock, active processing, and downtime breakouts at log-spaced breakpoints.

Can I configure custom breakpoints and downtime thresholds for Squid sync analysis?▼

Configuring custom breakpoints and downtime thresholds for Squid sync analysis is fully supported, allowing you to precisely measure active processing time and identify idle tail periods between log-spaced progress intervals.

Does Squid performance benchmarking require any specific CLI dependencies?▼

Squid performance benchmarking requires the sqd CLI to fetch logs and the expect dependency for script execution, ensuring accurate parsing of per-service progress data from your deployments.

Why does my Squid indexer exhibit idle tail time during synchronization?▼

Idle tail time during synchronization occurs when active processing stops between breakpoints, which you can identify by computing downtime thresholds from parsed log progress data to validate optimization bottlenecks.