Meditation Guide Builder

Creates personalized meditation scripts including body scan, loving-kindness, breathwork, visualization, and mindfulness practices adapted to your experience level, available time, and specific goals. Generates complete guided session scripts with timing cues, pause markers, and optional background sound suggestions. Whether you are a complete beginner or an experienced practitioner looking for fresh material, this tool tailors every session.

Supported Platforms & Integrations

Platform	Integration Type	Features
Insight Timer	Session format export	Timer intervals, bell cues, session structure
Headspace	Style reference	Technique alignment, progression framework
Calm	Style reference	Sleep story format, nature theme integration
Apple Health Mindful Minutes	Session logging format	Duration tracking, session categorization
Spotify / Apple Music	Background sound pairing	Ambient track suggestions by meditation type
Notion / Obsidian	Markdown export	Session library organization, tag-based retrieval

When to Use

• Daily practice creation: Generate a fresh 5-20 minute session each morning tailored to how you feel and what you need
• Stress or anxiety moment: Get an immediate 3-5 minute grounding script for acute stress situations
• Sleep preparation: Generate a progressive relaxation or yoga nidra script designed to guide you into sleep
• Building a meditation habit: Create a 30-day progressive curriculum that builds from 3 minutes to 20 minutes gradually
• Teaching or leading groups: Generate scripts for leading group meditation sessions at work, yoga class, or workshops
• Specific goal focus: Create targeted sessions for focus, creativity, emotional processing, pain management, or gratitude

Alternatives to Consider

• Headspace / Calm apps: If you prefer professionally recorded audio with music, narration, and visual guidance
• Local meditation class or sangha: If you want in-person community, teacher feedback, and traditional lineage instruction
• MBSR (Mindfulness-Based Stress Reduction): If you are dealing with chronic pain or clinical anxiety and want an 8-week structured clinical program

Quick Start

Copy
skill: meditation-guide-builder
config:
  type: body-scan
  duration_minutes: 15
  experience_level: beginner  # beginner | intermediate | advanced
  goal: stress-relief
  voice_tone: warm-gentle  # warm-gentle | neutral-clear | energetic
  include_timing_cues: true
  include_sound_suggestions: true

Example Input:

Type: Body scan meditation
Duration: 15 minutes
Level: Beginner
Goal: Stress relief after work
Preferences: Warm tone, nature imagery, include breathing focus

Example Output:

GUIDED BODY SCAN — Stress Relief (15 min)
============================================
Level: Beginner | Tone: Warm & Gentle
Sound suggestion: "Forest Rain" ambient or silence

[0:00 - 1:30] OPENING & SETTLING
"Find a comfortable position, either sitting or lying down.
Let your eyes close gently, or soften your gaze downward.
Take three deep breaths with me...
[PAUSE 4 seconds]
Breathe in slowly through your nose... hold briefly...
and release through your mouth with a gentle sigh.
[PAUSE 4 seconds]
Again... breathing in calm... and releasing tension.
[PAUSE 4 seconds]
One more... filling your lungs completely... and letting
everything go.

There's nothing you need to do right now. Nowhere to be.
Just this moment, this breath, this body."

[1:30 - 3:00] BREATH ANCHORING
"Let your breathing return to its natural rhythm. No need
to control it. Simply notice the rise and fall of your
chest or belly.
[PAUSE 8 seconds]
Each exhale is an invitation to soften a little more.
If your mind wanders — and it will — that's perfectly
normal. Simply guide your attention back to your breath
like you're redirecting a curious puppy. No frustration,
just gentle return.
[PAUSE 10 seconds]"

[3:00 - 11:00] BODY SCAN PROGRESSION
"Now let's move our attention through the body, starting
at the top of your head...

Notice any sensation at your scalp. Tingling, warmth,
or perhaps nothing at all. All responses are welcome.
[PAUSE 6 seconds]

Letting your attention flow down to your forehead...
the muscles around your eyes... your jaw...
[PAUSE 6 seconds]

(Script continues through: neck and shoulders → arms and
hands → chest and upper back → belly and lower back →
hips and legs → feet... each with pause markers and
release cues)"

[11:00 - 13:30] WHOLE BODY AWARENESS
"Now expand your attention to hold your entire body at
once, like a warm light filling you from head to toe..."

[13:30 - 15:00] CLOSING & RETURN
"Begin to deepen your breath... wiggle your fingers and
toes... When you're ready, open your eyes slowly, taking
this sense of calm with you into your evening."

SESSION METADATA:
  Technique: Progressive body scan
  Pause count: 24 silence markers
  Total silence: ~4 minutes
  Active guidance: ~11 minutes
  Suitable for: Solo practice, recording, or live reading

Advanced Configuration

Meditation Type Presets

Copy
# Loving-kindness (Metta)
type: loving-kindness
targets: [self, loved-one, neutral-person, difficult-person, all-beings]
phrases_style: traditional  # traditional | modern | custom

# Breathwork
type: breathwork
technique: box-breathing  # box-breathing | 4-7-8 | wim-hof | alternate-nostril
rounds: 5

# Visualization
type: visualization
theme: mountain-lake  # mountain-lake | forest-path | ocean | inner-light | custom
narrative_style: journey  # journey | static-scene | abstract

Parameters Reference

Parameter	Type	Default	Description
type	string	mindfulness	body-scan, loving-kindness, breathwork, visualization, mindfulness, yoga-nidra, sleep
duration_minutes	number	10	Session length (3-60 minutes)
experience_level	string	beginner	beginner, intermediate, advanced
goal	string	general	stress-relief, focus, sleep, anxiety, creativity, grief, gratitude, pain-management
voice_tone	string	warm-gentle	warm-gentle, neutral-clear, energetic, solemn
include_timing_cues	bool	true	Add [timestamp] markers throughout
include_sound_suggestions	bool	true	Suggest ambient audio pairings
pause_style	string	moderate	minimal (short pauses), moderate, spacious (long pauses)
imagery_theme	string	nature	nature, abstract, cosmic, ocean, forest, urban
include_affirmations	bool	false	Add positive affirmations to closing
progressive_curriculum	bool	false	Generate multi-day progression series
curriculum_days	number	7	Number of days for progressive curriculum

Core Concepts

Concept	Description
Anchor Point	The focal point for attention return (breath, body sensation, mantra) — every meditation needs one
Progressive Relaxation	Systematic tensing and releasing of muscle groups from head to toe for physical tension release
Loving-Kindness Phrases	Traditional well-wishing phrases directed to self, then expanding outward to all beings
Silence Ratio	Balance between spoken guidance and silent practice — beginners need more guidance (70/30), advanced more silence (30/70)
Session Arc	Every session follows: arrival/settling, main practice, integration, and gentle return

Session Architecture:

  ┌──────────────────────────────────────────────────────┐
  │                   Session Timeline                    │
  │                                                       │
  │  Arrival    Main Practice    Integration    Return    │
  │  (10-15%)   (60-70%)         (15-20%)      (5-10%)   │
  │                                                       │
  │  ┌──────┐  ┌────────────┐   ┌──────────┐  ┌──────┐  │
  │  │Settle│  │ Technique  │   │ Whole    │  │Gentle│  │
  │  │Breath│  │ Body Scan  │   │ Body     │  │Wake  │  │
  │  │Anchor│  │ or Metta   │   │ Awareness│  │Return│  │
  │  │      │  │ or Breath  │   │ Silence  │  │      │  │
  │  └──────┘  └────────────┘   └──────────┘  └──────┘  │
  │                                                       │
  │  Guidance:  ████░░░░████░░░░████████░░░░░░████░░░░   │
  │  Silence:   ░░░░████░░░░████░░░░░░░░████████░░░░████ │
  └──────────────────────────────────────────────────────┘

Workflow Examples

Scenario 1: Morning Focus Routine for Beginner

Input: Mindfulness meditation, 10 minutes, beginner, goal: focus for work day, neutral tone Process: Generate breath-focused session with attention training exercises and intention setting Output: 10-minute script with 3 phases: breath counting (3 min), open awareness (5 min), intention setting (2 min), 14 pause markers

Scenario 2: 30-Day Progressive Curriculum

Input: Mixed techniques, beginner starting at 5 min building to 20 min, goal: establish daily habit Process: Generate 30 daily scripts progressing in technique complexity and duration Output: Week 1: 5-min breath focus. Week 2: 8-min body awareness. Week 3: 12-min loving-kindness. Week 4: 20-min mixed practice. Each day unique.

Scenario 3: Sleep Preparation Script

Input: Yoga nidra style, 25 minutes, intermediate, goal: fall asleep, warm tone with nature imagery Process: Generate progressive relaxation with rotation of consciousness and visualization journey Output: 25-min yoga nidra script ending with sleep transition (no awakening cue), forest lake visualization, 31 pause markers, binaural beat suggestion

Best Practices

1. Start shorter than you think: A completed 5-minute session builds more habit strength than an abandoned 20-minute session — the tool defaults to manageable durations
2. Match technique to goal: Body scan for physical tension, loving-kindness for emotional difficulty, breathwork for energy, visualization for creativity — each technique has optimal applications
3. Maintain consistent timing: Practice at the same time daily when possible — the tool can generate morning, midday, or evening-specific sessions
4. Progress gradually: Use the progressive curriculum feature to build duration and complexity over weeks rather than jumping to advanced practices
5. Customize the language: If certain phrases or imagery do not resonate, use the custom theme and phrase options — meditation is deeply personal and one size never fits all

Common Issues

Issue: Scripts feel too wordy for experienced meditators Cause: Default beginner guidance ratio is 70% spoken / 30% silence Fix: Set experience_level to "advanced" and pause_style to "spacious" — this shifts to 30% guidance / 70% silence with minimal verbal cues.

Issue: Sleep meditation scripts wake me up at the end Cause: Standard sessions include a gentle awakening sequence in the closing Fix: Set goal to "sleep" — this removes the awakening cue, ends with a fade-to-silence, and uses progressively softer language in the final third.

Issue: Loving-kindness phrases feel forced or inauthentic Cause: Traditional Pali-derived phrases may not resonate with everyone Fix: Set phrases_style to "modern" for contemporary language, or "custom" to provide your own well-wishing phrases that feel natural and meaningful to you.

Privacy & Data Handling

All meditation scripts are generated locally on your machine. No personal information about your meditation practice, experience level, health goals, or emotional states is transmitted to any external service. Session preferences and practice history are not stored between runs — each generation is completely stateless. If you export sessions to Notion or other note-taking tools, that data is managed by those platforms under their privacy policies. This tool does not replace professional mental health support.