# Meditation

> Guide meditation practice. Use when starting timed sessions, breathing exercises, body scans, logging practice, or viewing stats.

- Skill: `bytesagain/meditation` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add bytesagain/meditation`
- Raw SKILL.md: https://api.skillmd.com/api/skills/bytesagain/meditation/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: bytesagain (https://skillmd.com/u/bytesagain)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/bytesagain/meditation

---


# Meditation Skill

Time meditation sessions, guide breathing and body scans, log practice, and track stats.

## Commands

### start

Start a meditation timer with optional bell intervals.

```bash
bash scripts/script.sh start [--duration <minutes>] [--bell <interval_min>] [--type focus|open|loving-kindness]
```

### breathe

Run a guided breathing exercise.

```bash
bash scripts/script.sh breathe [--pattern 4-7-8|box|deep] [--cycles <num>]
```

### body-scan

Generate a body scan meditation guide.

```bash
bash scripts/script.sh body-scan [--duration short|medium|long] [--focus full|upper|lower]
```

### log

Record a meditation session to the journal.

```bash
bash scripts/script.sh log <duration_min> [--type <type>] [--mood <1-10>] [--note <text>]
```

### stats

View meditation practice statistics.

```bash
bash scripts/script.sh stats [--period week|month|year|all] [--format table|json]
```

### playlist

Generate a meditation audio playlist.

```bash
bash scripts/script.sh playlist [--mood calm|sleep|focus|energy] [--duration <minutes>] [--count <num>]
```

## Output

All commands print to stdout. Session logs are stored in `~/.meditation/sessions.json`. Timer and breathing commands print real-time prompts to the terminal.


## Requirements
- bash 4+
- python3 (standard library only)

## Feedback

Questions or suggestions? → [https://bytesagain.com/feedback/](https://bytesagain.com/feedback/)

---

Powered by BytesAgain | bytesagain.com