qsv-performance

Optimize qsv CSV workflows using index files, stats cache, and Polars commands.

3.7k|104|Updated Dec 11, 2020
One-click install
npx skills add https://github.com/dathere/qsv --skill qsv-performance
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: qsv-performance
Source: https://github.com/dathere/qsv/tree/main/.claude/skills/skills/qsv-performance
Command: npx skills add https://github.com/dathere/qsv --skill qsv-performance

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

qsv performance can be slow on large CSV datasets due to repeated scans and lack of contextual caching. This guide shows how to speed up workflows by using index files, a stats cache, and frequency caches to avoid repeated work.

Core Features & Use Cases

  • Index Files: Create per-file indices (.csv.idx) to enable instant row counts and O(1) lookups for repeated queries.
  • Stats Cache: Maintain .stats.csv and .stats.csv.data.jsonl to accelerate frequency, schema, and join planning.
  • Polars Engine: Use Polars-enabled commands (sqlp, joinp, pivotp) for large or complex analyses.
  • Rule: Always enable the accelerators for repeated operations on the same file to realize the best gains.

Quick Start

Run a workflow that enables indexing, activates the stats cache, and uses the frequency cache to speed up a typical qsv analysis.

Frequently Asked Questions about qsv-performance

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

FAQPage Schema
How do I speed up qsv analysis on large CSV files?

Speed up qsv analysis on large CSV files by creating index files (.csv.idx), enabling a stats cache, and using Polars-based commands to avoid repeated full dataset scans.

What is a CSV index file and how does it optimize performance?

A CSV index file (.csv.idx) optimizes performance by enabling instant row counts and O(1) lookups for repeated queries, eliminating the need to scan the entire dataset every time.

How do I cache CSV stats to accelerate frequency and join planning?

Cache CSV stats by generating and maintaining .stats.csv and .stats.csv.data.jsonl files, which accelerate frequency calculations, schema inference, and join planning across repeated operations.

When should I use Polars commands like joinp or sqlp for CSV processing?

Use Polars commands like joinp, sqlp, or pivotp when processing large or complex CSV analyses, as the Polars engine provides superior performance compared to standard qsv commands for heavy workloads.

Does qsv performance optimization require dependencies or external libraries?

No, qsv performance optimization requires no external dependencies, relying entirely on internal features like index files, stats caches, and built-in Polars-enabled commands to accelerate workflows.

Why is my qsv count or slice command slow on repetitive CSV tasks?

qsv count or slice commands are slow on repetitive tasks because they scan the entire CSV file each time, but enabling index files and caches prevents this repeated work.