reproducible-analysis

Create and maintain a JSONL journal capturing data operations for reproducible analysis.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Reproducible analysis is hard when steps are scattered across scripts and outputs; this skill provides a unified, machine-readable journal to capture every data operation so analyses can be replayed and verified end-to-end.

Core Features & Use Cases

  • Automatic generation of a <analysis-name>.journal.jsonl file that records each operation as a JSON object with fields like seq, ts, op, tool, input, input_sha256, output, output_sha256, duration_ms, and note.
  • Supports deterministic replay across environments, enabling auditors and teammates to reproduce results given the same inputs and toolchain.
  • Works with common data formats (CSV, JSON, Parquet) and multiple data-processing steps (indexing, filtering, joining, statistics).

Quick Start

Create the first reproducible journal entry by running an analysis step and appending its details to a file named <analysis-name>.journal.jsonl.

Frequently Asked Questions about reproducible-analysis

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

FAQPage Schema
How do I make my data analysis reproducible across different environments?▼

To make data analysis reproducible across environments, you need a machine-readable journal that records every operation. This skill automates capturing steps like filtering and joining in a stable JSONL format, enabling deterministic replay and end-to-end verification.

What is a JSONL journal format for deterministic replay of data operations?▼

A JSONL journal format for deterministic replay is a structured log where each line is a JSON object capturing a data operation. It stores fields like seq, ts, op, input, input_sha256, and output_sha256 to verify that analyses produce identical results across different toolchains.

How do I log data operations like filtering and joining for audit verification?▼

You log data operations for audit verification by appending each step's details to an analysis journal file. This skill automatically records the operation, input, output, duration, and cryptographic hashes to a JSONL file, ensuring teammates can reproduce results.

Can I use this reproducible journal with CSV, JSON, and Parquet file formats?▼

Yes, the reproducible journal works with common data formats including CSV, JSON, and Parquet. It records multiple data-processing steps such as indexing, filtering, joining, and statistics, capturing inputs and outputs regardless of the underlying file format.

What fields are required in a reproducible analysis journal entry?▼

A reproducible analysis journal entry requires a consistent schema storing fields such as seq, ts, op, input, input_sha256, output, output_sha256, duration_ms, and note. These fields ensure every data operation is verifiable and machine-readable.

Why does my data analysis pipeline fail to produce identical outputs when replayed?▼

Data analysis pipelines fail to produce identical outputs when steps are scattered across scripts without a unified log. A machine-readable journal solves this by capturing each operation with input and output hashes, enabling deterministic replay and verification.