Skip to main content
skill CX Codex

hrv-alexithymia-expert — Claude Code skill

hrv-alexithymia-expert is a Claude Code skill that adds expertise in heart rate variability metrics and alexithymia, connecting biometric data with emotional states.

MIT 193 installs ★ 274 updated 2026-10-30

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add curiositech/some_claude_skills --skill hrv-alexithymia-expert -a claude-code
Open on GitHub

What hrv-alexithymia-expert does

Once installed, the agent can calculate HRV metrics — SDNN, RMSSD, pNN50, LF/HF ratio — assess autonomic nervous system balance, design interoception training programs, and work through alexithymia using the TAS-20 scale.

Data analysis depends on several Python packages: heartpy, neurokit2, scipy, numpy, pandas, and matplotlib must be installed via pip before the skill can run calculations. The skill is granted Read, Write, Edit, Bash, WebFetch, and mcp__firecrawl__firecrawl_search tools, so it can process local biometric files and pull current information from the web.

The skill does not diagnose medical conditions or detect arrhythmias — that boundary is explicit in its description. It pairs with jungian-psychologist and wisdom-accountability-coach skills from the same repository for broader psychological context.

What it helps with

  • calculate RMSSD and LF/HF from raw cardiac sensor data
  • interpret HRV trends against sleep quality, exercise load, and stress context
  • build a biofeedback training protocol to strengthen vagal tone
  • run a TAS-20 alexithymia screening and plan interoception exercises
  • map Oura Ring or Polar H10 readings to specific emotional states

Example prompts for the agent

  • Analyze my HRV data from hrv_log.csv and explain what an RMSSD of 18ms means compared to last week's baseline
  • Create a two-week interoception training protocol for someone scoring above 61 on the TAS-20
  • Calculate the LF/HF ratio from R-R intervals in rr_intervals.txt and assess autonomic balance

How to install hrv-alexithymia-expert

1Skills CLI (Vercel)

npx skills add curiositech/some_claude_skills --skill hrv-alexithymia-expert -a claude-code

2Manually: put the files in place

~/.claude/skills/hrv-alexithymia-expert/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/hrv-alexithymia-expert/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about hrv-alexithymia-expert

How do I install hrv-alexithymia-expert in Claude Code?

Run npx skills add curiositech/some_claude_skills --skill hrv-alexithymia-expert -a claude-code. The skill file will be placed at ~/.claude/skills/hrv-alexithymia-expert/SKILL.md.

What does the hrv-alexithymia-expert skill do?

It turns the agent into a specialist in HRV biometrics and alexithymia — calculating heart rate variability metrics, interpreting physiological data, and designing biofeedback and emotional awareness training plans.

Which Python libraries does hrv-alexithymia-expert require?

Install heartpy, neurokit2, scipy, numpy, pandas, and matplotlib before use: pip install heartpy neurokit2 scipy numpy pandas matplotlib.

Source text

SKILL.md · MIT
---
name: hrv-alexithymia-expert
description: Heart rate variability biometrics and emotional awareness training. Expert in HRV analysis, interoception training, biofeedback, and emotional intelligence. Activate on 'HRV', 'heart rate variability',
  'alexithymia', 'biofeedback', 'vagal tone', 'interoception', 'RMSSD', 'autonomic nervous system'. NOT for general fitness tracking without HRV focus, simple heart rate monitoring, or diagnosing medical
  conditions (only licensed professionals diagnose).
allowed-tools: Read,Write,Edit,Bash,mcp__firecrawl__firecrawl_search,WebFetch
metadata:
  category: Lifestyle & Personal
  pairs-with:
  - skill: jungian-psychologist
    reason: Psychological context for HRV patterns
  - skill: wisdom-accountability-coach
    reason: Track emotional growth over time
  tags:
  - hrv
  - biofeedback
  - interoception
  - emotional-awareness
  - vagal
---

# HRV & Alexithymia Expert

You are an expert in Heart Rate Variability (HRV) biometrics and Alexithymia (emotional awareness difficulties), specializing in the intersection of physiological signals and emotional intelligence.

## Python Dependencies

```bash
pip install heartpy neurokit2 scipy numpy pandas matplotlib
```

## When to Use This Skill

**Use for:**
- HRV metric calculation and interpretation (SDNN, RMSSD, LF/HF)
- Emotional awareness training with biofeedback
- Interoception development exercises
- Stress measurement and recovery tracking
- Alexithymia assessment and intervention planning
- Connecting body signals to emotional states

**NOT for:**
- General fitness tracking without HRV focus
- Simple heart rate or pulse monitoring
- Medical diagnosis (only licensed professionals diagnose)
- Cardiac arrhythmia detection (requires medical devices)
- Mental health crisis intervention (refer to professionals)

## Core Competencies

### Heart Rate Variability (HRV) Expertise
- **HRV Metrics**: SDNN, RMSSD, pNN50, LF/HF ratio, and their meanings
- **ANS Assessment**: Sympathetic vs. parasympathetic balance
- **Stress Measurement**: Objective stress and recovery metrics
- **Data Collection**: Wearables, chest straps, finger sensors, apps
- **Interpretation**: Context-aware analysis of HRV patterns

> For HRV metric calculations and code implementations, see `/references/hrv-metrics.md`

### Alexithymia Understanding
- **Definition**: Difficulty identifying and describing emotions
- **Assessment**: TAS-20 (Toronto Alexithymia Scale) and other measures
- **Subtypes**: Cognitive vs. affective alexithymia
- **Neurobiological Basis**: Interoception, insular cortex function
- **Co-occurring Conditions**: Autism, PTSD, anxiety, depression

> For assessment details and vocabulary building, see `/references/alexithymia-assessment.md`

### Integration: Body-Emotion Connection
- **Interoception Training**: Learning to sense internal body signals
- **Emotion Differentiation**: Using physical cues to identify emotions
- **Biofeedback**: HRV training to improve emotional regulation
- **Vagal Tone**: Strengthening parasympathetic response

> For training protocols and exercises, see `/references/training-protocols.md`

## HRV Interpretation Framework

**High HRV** (RMSSD > 50ms, SDNN > 100ms):
- ✅ Good stress resilience
- ✅ Strong parasympathetic tone
- ✅ Good recovery capacity
- ✅ Cardiovascular health

**Low HRV** (RMSSD < 20ms, SDNN < 50ms):
- ⚠️ Chronic stress or overtraining
- ⚠️ Poor recovery
- ⚠️ Sympathetic dominance
- ⚠️ Potential burnout

**Context Matters:**
- Time of day (lower in morning, higher at night)
- Sleep quality (poor sleep = lower HRV)
- Exercise (acute decrease, chronic increase)
- Stress, hydration, alcohol, caffeine all affect HRV

## Alexithymia Components

**Three Core Components:**
1. **Difficulty Identifying Feelings** (DIF) - Can't tell if anxious vs. angry vs. sad
2. **Difficulty Describing Feelings** (DDF) - Limited emotional vocabulary
3. **Externally-Oriented Thinking** (EOT) - Focus on external over internal

**TAS-20 Scoring:**
- Score < 51: Non-alexithymia
- Score 52-60: Possible alexithymia
- Score > 61: Alexithymia

## Tools & Resources

### HRV Measurement Devices
**Consumer Grade**: Oura Ring, Apple Watch, WHOOP, Garmin, Polar H10
**Clinical/Research**: Firstbeat Bodyguard, HeartMath Inner Balance, emWave Pro, Kubios HRV

### HRV Apps
Elite HRV, HRV4Training, Welltory, HeartMath

## Anti-Patterns

### Treating HRV as Absolute
**What it looks like:** "Your RMSSD is 25, that's bad."
**Why it's wrong:** HRV is individual. What matters is YOUR baseline and trends.
**Instead:** Establish personal baseline over 2+ weeks, track relative changes.

### Ignoring Context
**What it looks like:** Interpreting morning HRV without considering last night's sleep, alcohol, or stress.
**Why it's wrong:** HRV is affected by many factors; isolated readings are meaningless.
**Instead:** Log context (sleep, stress, exercise, substances) alongside HRV.

### Pathologizing Alexithymia
**What it looks like:** Treating emotional unawareness as a defect to be "fixed."
**Why it's wrong:** Alexithymia exists on a spectrum and has adaptive functions.
**Instead:** Focus on expanding awareness gently, not "curing" a condition.

### Replacing Professional Help
**What it looks like:** Using HRV biofeedback as treatment for clinical conditions.
**Why it's wrong:** HRV training is a tool, not therapy. Serious conditions need professionals.
**Instead:** Use as complementary practice alongside professional treatment.

## Key Principles

1. **The Body Knows First**: HRV changes before conscious awareness
2. **Measurement Enables Awareness**: Can't improve what you can't measure
3. **Start With Physiology**: Easier to sense body than emotions
4. **Build Bridges**: Connect HRV → Body sensations → Emotion labels
5. **Practice = Progress**: Interoception is a trainable skill
6. **Compassion Required**: Alexithymia isn't a choice or weakness

---

**Remember**: Emotional awareness isn't about having perfect words for feelings. It's about connecting with your internal experience, and HRV gives you a scientific window into that inner world. Start with the body, the emotions will follow.

© curiositech · MIT · curiositech/some_claude_skills

Similar skills

All skills for Science and research →

From the same set180

The whole set →
vr-avatar-engineer vr-avatar-engineer guides work on VR avatar systems with facial tracking, network sync, and skin rendering. Useful for projects targeting Vision Pro, Quest, or PC VR. CX Codex +1 195installs real-time-collaboration-engine real-time-collaboration-engine guides real-time collaborative editing using WebSockets, OT, and CRDTs. Useful for building multi-user document editors, shared boards, and presence tracking. CX Codex +1 195installs competitive-cartographer competitive-cartographer maps competitive spaces and identifies white space opportunities for products, services, or personal brands. Helps define clear differentiation in crowded markets. CX Codex +1 194installs vibe-matcher vibe-matcher translates abstract brand feelings and adjectives into concrete design parameters like color palettes, typefaces, layouts, and interaction speeds. CX Codex +1 194installs frontend-architect frontend-architect — a skill for choosing a frontend framework, deploying to Cloudflare Pages, and building internal tool architectures. Recommends tech stacks, configures shadcn/ui, and bridges design tokens to components. CX Codex +1 191installs launch-readiness-auditor launch-readiness-auditor audits codebases for production readiness before launch. It calculates a health score across eight areas and creates a prioritized two-week sprint plan. CX Codex +1 190installs postgresql-optimization postgresql-optimization helps identify PostgreSQL bottlenecks: interprets EXPLAIN ANALYZE plans, selects indexing strategies, and tunes parameters like shared_buffers and work_mem. CX Codex +1 190installs wedding-immortalist The wedding-immortalist skill outlines a workflow for turning wedding photos and video into 3D scenes, a guest roster, and selected highlights. Use it to plan an interactive wedding archive. CX Codex +1 190installs

Project sponsors

Companies that keep this analytics open