csv-metadata-forensic

Reconstruct user activity timelines by cross-referencing metadata headers across multiple CSV export files.

13|2|Updated Feb 10, 2026
One-click install
npx skills add https://github.com/aaddrick/written-voice-replication --skill csv-metadata-forensic-aaddrick
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: csv-metadata-forensic
Source: https://github.com/aaddrick/written-voice-replication/tree/main/.claude/skills/csv-metadata-forensic
Command: npx skills add https://github.com/aaddrick/written-voice-replication --skill csv-metadata-forensic-aaddrick

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pandas.

What problem does it solve? When you receive a structured data export (platform takeout, GDPR export, API dump) containing many CSV files, it is hard to know what the data actually contains before diving into content analysis. This Skill extracts everything the metadata alone can tell you: schemas, timestamps, shared keys, baseline metrics, PII columns, and data gaps. ## Core Features & Use Cases - Schema Mapping & Key Discovery: Extract headers from every CSV, infer column types, and find shared columns that serve as join keys across files. - Temporal Reconstruction: Build an activity timeline from timestamps scattered across files and calculate account lifespan, activity rates, and content creation ratios. - PII Scanning & Gap Analysis: Flag columns containing IPs, emails, or phone numbers, and identify empty files, schema mismatches, and orphan references. - Use Case: You receive a Reddit GDPR export with 20 CSV files. Use this Skill to produce a forensic report covering file inventory, temporal bounds, baseline metrics, and data quality issues before any content-level analysis. ## Quick Start Use the csv-metadata-forensic skill to analyze all CSV files in this export directory and write a forensic reconstruction report to docs/analysis/01-csv-metadata-forensic.md.

Frequently Asked Questions about csv-metadata-forensic

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

FAQPage Schema
How do I analyze multiple CSV files from a data export?

Start by inventorying every CSV with row counts and checksums, then extract headers to build a schema map. Find shared columns across files as join keys, extract timestamp bounds for a timeline, and calculate baseline metrics before any content analysis.

How to find shared columns across multiple CSV files in Python?

Read the header row of each CSV and build a dictionary mapping each column name to the files containing it. Columns appearing in two or more files are candidate join keys, such as id, permalink, date, or subreddit fields.

Can I calculate account lifespan from CSV export metadata?

Yes, account lifespan is the delta between the registration timestamp and the most recent activity timestamp across all files. If the registration date is missing, use the earliest observed timestamp as a lower-bound proxy and note the limitation.

Why does pandas read_csv corrupt ID columns in CSV files?

Auto type detection converts IDs to integers, losing leading zeros or causing overflow on long values. Pass dtype=str for ID and hash columns, and specify parse_dates explicitly for date columns instead of relying on inference.

When should I not use metadata-only forensic analysis?

Avoid it for single CSV files with no cross-reference potential, unstructured data like logs or freeform text, and when you need content-level analysis such as sentiment or topic modeling. Metadata reveals what and when, never why.