whoop

Parse and clean WHOOP export data into pandas DataFrames for time-series analysis.

Updated May 12, 2026
One-click install
npx skills add https://github.com/aquiladev/claude-skills --skill whoop-aquiladev
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: whoop
Source: https://github.com/aquiladev/claude-skills/tree/main/skills/whoop
Command: npx skills add https://github.com/aquiladev/claude-skills --skill whoop-aquiladev

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pandas, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill solves the complexity of interpreting raw WHOOP export data, which is organized by physiological cycles rather than calendar days, making it difficult to perform meaningful longitudinal analysis.

Core Features & Use Cases

  • Data Normalization: Automatically cleans and joins physiological cycles, sleep, workout, and journal data into structured pandas DataFrames.
  • Contextual Analysis: Handles the unique WHOOP cycle logic, allowing you to correlate daily strain and recovery with specific journaled behaviors or workout intensities.
  • Use Case: Use this to determine if specific habits, like caffeine consumption or rest days, statistically correlate with your recovery scores or sleep quality over a multi-month period.

Quick Start

Use the whoop skill to load the data from my latest export folder and calculate my average recovery score for the last thirty days.

Frequently Asked Questions about whoop

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

FAQPage Schema
How do I analyze WHOOP recovery and sleep data using pandas?

To analyze WHOOP recovery and sleep data using pandas, this Skill parses raw physiological cycle exports into structured DataFrames, normalizing sleep, strain, and journal entries for time-series analysis. It automatically cleans and joins the data for accurate longitudinal insights.

What is the best way to correlate WHOOP journal entries with recovery scores?

The best way to correlate WHOOP journal entries with recovery scores is by using cycle-based grouping logic. This Skill joins journaled behaviors, like caffeine consumption, with recovery metrics to identify statistical correlations over multi-month periods.

How do I handle timezone-aware timestamps when parsing WHOOP export data?

Handling timezone-aware timestamps when parsing WHOOP export data is built into this Skill. It processes physiological cycle data with timezone-aware timestamp handling to ensure accurate time-series alignment for longitudinal fitness tracking.

Does this Skill require pandas for WHOOP data manipulation?

Yes, this Skill requires pandas for WHOOP data manipulation. It relies on the pandas framework to clean, join, and structure physiological cycles, sleep, and workout data into DataFrames for complex queries.

Why does my WHOOP longitudinal analysis misalign with calendar days?

Your WHOOP longitudinal analysis misaligns with calendar days because the platform organizes data by physiological cycles. This Skill resolves the issue by parsing and normalizing cycle-based grouping for accurate time-series analysis.