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.