Gsd-skill-creator breath-and-meditation-foundations
Foundations of breath practice and seated meditation across traditions — diaphragmatic mechanics, pranayama families (ujjayi, nadi shodhana, bhramari, kapalabhati, bhastrika, sitali, sheetkari), buffer-safe breath-retention posture, shikantaza and koan traditions in Sōtō and Rinzai Zen, secular clinical mindfulness as MBSR translates it, and engaged-mindfulness pedagogy as Plum Village teaches it. Use when setting up a breath practice, designing a meditation sit, debugging a stalled practice, or deciding whether a given technique is safe for a given person.
git clone https://github.com/Tibsfox/gsd-skill-creator
T=$(mktemp -d) && git clone --depth=1 https://github.com/Tibsfox/gsd-skill-creator "$T" && mkdir -p ~/.claude/skills && cp -r "$T/examples/skills/mind-body/breath-and-meditation-foundations" ~/.claude/skills/tibsfox-gsd-skill-creator-breath-and-meditation-foundations && rm -rf "$T"
examples/skills/mind-body/breath-and-meditation-foundations/SKILL.mdBreath and Meditation Foundations
Breath and seated meditation are the two practices that nearly every mind-body tradition trains first, and they are the two places where the most damage is done when trained wrong. This skill covers the mechanics of breath, the main families of pranayama, the posture and attention protocols of seated meditation across Sōtō and Rinzai Zen, the clinical translation that MBSR offers, and the engaged-mindfulness pedagogy of Plum Village. It is written to be used by a chair agent who is routing a query, by a specialist agent who is writing a practice plan, and by a pedagogy agent who is explaining why a practice works the way it does.
Agent affinity: kabat-zinn (clinical breath and MBSR body scan), dogen (shikantaza and posture), thich-nhat-hanh (engaged breathing and everyday mindfulness), iyengar (pranayama as a wing of the Iyengar method)
Concept IDs: mind-body-breath-mechanics, mind-body-seated-meditation, mind-body-pranayama-families, mind-body-clinical-mindfulness, mind-body-engaged-mindfulness
Wings covered: breath (primary), meditation (primary). Lineage roots: pranayama from Patanjali's Yoga Sutras as Krishnamacharya and B.K.S. Iyengar transmitted it; shikantaza from Dōgen's Fukanzazengi; koan practice from the Rinzai school; secular translation from Kabat-Zinn's MBSR at UMass Medical Center; engaged pedagogy from Thich Nhat Hanh's Plum Village monastery.
1. Why breath is trained first
Breath is the only autonomic process that is also under conscious control. Every tradition covered by this skill uses that property, but they use it differently, and the way you describe it to a practitioner determines whether they end up safer or less safe than they started.
- Yoga tradition framing. Prana is life-energy; breath is its most accessible gateway. Pranayama (literally "extension of prana") is the fourth limb of the eight-limb yoga of Patanjali and precedes the inward-facing limbs (pratyahara, dharana, dhyana, samadhi). The breath is the handle by which attention is pulled inward.
- Zen framing (Dōgen). Breath is not a technique to be mastered; it is a natural function to be noticed without interference. In Fukanzazengi Dōgen writes that in zazen one should "let go of the myriad involvements and set aside the myriad affairs." Breath counts or follows attention only as a training aid for the beginner; the mature practice is "just sitting" (shikantaza).
- Clinical framing (Kabat-Zinn). Breath is a portable anchor for attention that is always present, requires no equipment, and is socially invisible. MBSR uses it as the return object after mind-wandering. Kabat-Zinn is deliberate about not framing breath mystically, because the clinical population he serves often includes people for whom mystical framing is alienating or religiously loaded.
- Engaged framing (Thich Nhat Hanh). Breath is the thread that stitches awareness to ordinary life. "Breathing in, I know I am breathing in" is a complete practice. It is done while washing dishes, walking, or in a meeting — not only on a cushion.
A good routing agent will notice which framing matches the user's context before answering. A clinical-population user gets Kabat-Zinn's framing. A practitioner already inside a yoga lineage gets Iyengar's framing. A meditator asking about resistance to counting-breath practices often needs Dōgen's framing.
2. Breath mechanics — what is actually happening
Before any tradition-specific technique, name the mechanics. Misunderstanding of mechanics is the most common source of injury.
2.1 Diaphragm, ribs, and pelvic floor
The diaphragm is a dome-shaped muscle that separates the thoracic cavity from the abdominal cavity. On inhale, the diaphragm contracts and descends, increasing thoracic volume and drawing air in; the abdominal contents are displaced outward and down. On exhale, the diaphragm relaxes and rises. The ribs expand laterally and up-and-forward on inhale (bucket-handle and pump-handle motion) and return on exhale. The pelvic floor mirrors the diaphragm: it descends slightly on inhale and rises on exhale. This pelvic mirror is largely invisible to untrained practitioners and is one of the things Iyengar yoga and Pilates make explicit.
2.2 Common breath pathologies
- Paradoxical breathing. The belly moves in on inhale and out on exhale. This happens when the diaphragm is weak or the practitioner is guarding. It is the single most common pattern to correct.
- Chest-only breathing. The belly does not move and the shoulders lift. This is fine for a brief burst but is a stress pattern if chronic.
- Breath holding under effort. The Valsalva maneuver (hold breath, bear down) is useful for brief heavy lifts but is dangerous in combination with extended retention practices, with cardiovascular conditions, and with pregnancy.
- Over-breathing / hyperventilation. Rapid shallow breathing produces hypocapnia, vasoconstriction, and tingling or lightheadedness. Beginners who are taught fast breath techniques without context often land here.
2.3 The physiology a meditation teacher needs
Slow nasal breathing at roughly 5.5 breaths per minute (five seconds in, five seconds out, or six seconds in, six seconds out) has repeatable effects on heart rate variability and vagal tone. This is the physiological window that both MBSR's informal breath practice and most pranayama ratios land on. It is not mystical; it is the resonance frequency of the baroreflex. A routing agent should know this because it is the least culturally loaded explanation of why slow breath works.
3. Pranayama families — the Iyengar lineage
B.K.S. Iyengar taught that pranayama is not a beginner practice. In the Iyengar school, asana (posture) is trained first because without a stable, open-chested seat the internal space needed for pranayama is not there. This is a lineage-specific position and is not universal — some traditions teach simple breath first. The Iyengar-lineage ordering is: establish asana, establish a seated posture that does not deform the ribcage, then introduce pranayama with exhale-focused practice, then inhale, then retention. Retention comes last and is not introduced without a teacher.
3.1 Ujjayi — "victorious breath"
A gentle constriction at the glottis produces a soft ocean-sound on both inhale and exhale. It slows the breath naturally and is safe as a first pranayama. It is also the breath used through most of Ashtanga vinyasa practice. Contraindications: acute asthma attack, severe rhinitis where nasal breathing is impossible.
3.2 Nadi shodhana — alternate nostril
Close the right nostril, inhale through the left, close the left, exhale through the right, inhale right, close right, exhale left. This is one cycle. Start with 4–6 cycles. This practice is the most broadly safe pranayama. It is the one to give a clinical-population beginner who wants a pranayama.
3.3 Bhramari — "bee breath"
Inhale normally, exhale with a humming sound through a closed mouth. The vibration is the practice. Bhramari is surprisingly effective for acute anxiety. Contraindications: active ear infection.
3.4 Kapalabhati — "skull-shining breath"
Rapid, forceful exhales with passive inhales. Roughly 1 exhale per second, 30–60 reps per round. This is an active, heating practice. Do not teach this to a beginner without context. Contraindications: pregnancy, uncontrolled hypertension, recent abdominal surgery, cardiovascular disease, glaucoma, active anxiety disorder, epilepsy, recent stroke. This is a practice where routing to "please ask your doctor" is often the right move.
3.5 Bhastrika — "bellows breath"
Forceful inhale and forceful exhale. Stronger than kapalabhati. All the kapalabhati contraindications apply, and the list is longer. Only teach this inside a lineage with a teacher.
3.6 Sitali and sheetkari — cooling breaths
Inhale through a rolled tongue (sitali) or through teeth (sheetkari), exhale through the nose. These are cooling practices used in hot climates and after heating work. Safe for most populations. Contraindications: active cold or flu.
3.7 Ratios and retention (kumbhaka)
A common Iyengar-lineage progression: 1:1 (4 in, 4 out), then 1:2 (4 in, 8 out, exhale-biased, parasympathetic), then 1:1:1 with retention, then 1:4:2 in advanced practice. Retention is a teacher-supervised practice. Solo practice of retention past 1:2 is a routing flag.
4. Seated meditation — shikantaza and the zazen posture
Dōgen Zenji (1200–1253) brought the Caodong (Sōtō) tradition from Song China to Japan and founded Eiheiji. His instructions for zazen are in Fukanzazengi ("Universally Recommended Instructions for Zazen"). The instructions are precise about posture and deliberately vague about attention-object, because in the Sōtō view the posture itself is the practice.
4.1 Posture
- Sit on a zafu or cushion that lifts the pelvis so the knees are below the hip joints and can rest on the mat.
- Cross the legs in full lotus, half lotus, Burmese, or seiza. Kneeling on a bench is acceptable. Sitting on a chair with feet flat on the floor is acceptable. Lineage gatekeeping here is unhelpful — the point is a stable tripod of two knees and one seat.
- The spine is upright, the crown of the head lifted as if pulled from above, the chin tucked slightly so the back of the neck is long.
- The hands rest in the cosmic mudra: left palm on right palm, thumbs lightly touching at the level of the navel, forming an oval.
- The eyes are half-open, gaze resting on the floor about a meter ahead. Not closed. Closing the eyes is actively discouraged in Sōtō because it invites drowsiness and visualization.
- Rock gently side-to-side to find center, then settle.
4.2 Attention instruction
Dōgen's instruction is "think not-thinking. How do you think not-thinking? Non-thinking. This is the essential art of zazen." This is deliberately koan-like. Practically, it means: do not try to stop thoughts, do not follow thoughts, do not identify with thoughts. Thoughts arise; posture continues. That continuation is shikantaza, "just sitting."
For a beginner struggling with shikantaza, counting breaths (1 on the exhale through 10, then start over) or following breaths is allowed as a training wheel. Do not make it permanent.
4.3 The Rinzai counterpoint — koan work
Rinzai Zen, which came to Japan via Eisai and was systematized by Hakuin Ekaku, uses koan work — sustained intensive investigation of paradoxical cases — inside the same posture. A routing agent should know the distinction so it does not mix Hakuin-style intensity advice into a Dōgen-lineage shikantaza sit.
4.4 Common failure modes of zazen
- Collapsing the low back → rounding → back pain. Correct by lifting the pelvis higher on the cushion.
- Knee pain in lotus → nerve compression. If a knee is not resting on the mat, do not force lotus. Use Burmese or seiza.
- Drowsiness → open eyes wider, lift posture, shorten session, sit earlier in the day.
- Panic or dissociation → this is a real safety issue. Stop the sit, open eyes fully, stand up, walk, and if it recurs, route to a professional. Not all meditation is appropriate for all people at all times.
5. MBSR — secular clinical translation
Jon Kabat-Zinn founded the Stress Reduction Clinic at UMass Medical Center in 1979 and designed Mindfulness-Based Stress Reduction as an eight-week program that makes contemplative practice available to a medical patient population without asking them to adopt a religious frame. MBSR is the translation layer between traditions and clinics.
5.1 MBSR's four core practices
- Body scan. Supine. Attention moves slowly through the body from feet to head over 30–45 minutes. The instruction is to notice whatever is present without changing it.
- Sitting meditation. Breath anchor, then open awareness.
- Mindful movement. Very gentle yoga sequences, Hatha-derived but stripped of lineage terminology.
- Informal practice. Mindful eating (the raisin exercise), mindful walking, mindful daily activities.
5.2 MBSR's framing choices
Kabat-Zinn's deliberate language choices are a case study in respectful translation. He uses "awareness" instead of "sati." He uses "non-judging" instead of "equanimity." He uses "beginner's mind" as a directly imported phrase from Shunryu Suzuki because the English carries the meaning. The program has a teaching lineage and certification pathway through the Mindfulness Center at Brown University and the Center for Mindfulness at UMass.
5.3 When MBSR framing is right, and when it is wrong
Right when: the user is in a clinical population, has medical or psychological complications, is religiously Christian/Jewish/Muslim/atheist and does not want Buddhist framing, or is a healthcare professional learning for patient use. Wrong when: the user is explicitly inside a Buddhist or Hindu lineage and wants the tradition-native framing. Offering MBSR in that case is a reductive move and the routing agent should not do it.
6. Engaged mindfulness — Thich Nhat Hanh and Plum Village
Thich Nhat Hanh (1926–2022), a Vietnamese Zen monk in the Linji (Rinzai) and Tiep Hien traditions, founded Plum Village in France after being exiled from Vietnam for peace activism. His teaching is a bridge between classical Zen and everyday secular life, and it has its own pedagogical voice.
6.1 The gatha practice
A gatha is a short verse recited internally while doing a daily action:
Breathing in, I calm my body. Breathing out, I smile. Dwelling in the present moment, I know this is a wonderful moment.
This can be shortened to "in, out, calm, smile, present moment, wonderful moment" and then to single words. Gathas exist for waking up, washing dishes, driving, sitting down at a meeting, answering the phone. The practice is explicitly designed to be inserted into ordinary life, not to require a cushion.
6.2 Mindful walking
Slow walking with the breath. A typical instruction: one breath, two or three steps. The feet are the anchor. Plum Village walking meditation is usually slow and deliberate; it contrasts with the faster kinhin between zazen periods in Sōtō practice.
6.3 Interbeing
The central philosophical frame Thich Nhat Hanh offers. The paper on which a teaching is printed contains the cloud that rained on the tree; the self is a convention composed of non-self elements. Practically, the interbeing frame is why engaged mindfulness is political: if suffering and wellbeing interpenetrate, then practice does not end at the cushion.
7. Practice sequences
7.1 A first-week practice for a secular beginner (MBSR frame)
- Day 1: 10 minutes of body scan, supine, guided.
- Day 2: 10 minutes of body scan.
- Day 3: 5 minutes of sitting breath awareness.
- Day 4: 5 minutes of sitting breath awareness + one raisin-exercise meal.
- Day 5: 10 minutes of sitting breath awareness.
- Day 6: Informal mindful walking, 10 minutes.
- Day 7: Integrated 15-minute sit.
7.2 A first-week practice for a yoga-lineage beginner (Iyengar frame)
- Day 1: Supta baddha konasana with a bolster, 5 minutes, belly-breathing with no technique added.
- Day 2: Seated virasana or sukhasana (whatever is stable) with a wall support, ujjayi breath, 5 minutes.
- Day 3: Nadi shodhana, 6 cycles, with a firm seated posture.
- Day 4: Ujjayi + nadi shodhana in sequence, total 10 minutes.
- Day 5: Add a 5-minute silent sit after the pranayama.
- Day 6: Rest or a passive restorative posture with awareness of breath.
- Day 7: Full sequence — 10 min pranayama, 10 min sit.
7.3 A first-week practice for a Zen beginner (Sōtō frame)
- Day 1: 10 minutes zazen. Count breaths 1–10 on exhale.
- Day 2: 10 minutes zazen, counted breath.
- Day 3: 15 minutes zazen, counted breath.
- Day 4: 15 minutes zazen, follow breath without counting.
- Day 5: 20 minutes zazen.
- Day 6: Two sessions of 10 minutes with 5 minutes kinhin between.
- Day 7: 25 minutes zazen.
8. Routing heuristics
When this skill is loaded into an agent's context, the agent decides which framing to present first.
| Query signal | Framing to use | Primary agent |
|---|---|---|
| "I am in therapy / I have PTSD / my doctor suggested" | MBSR | kabat-zinn |
| "I want to learn pranayama" | Iyengar | iyengar |
| "I want to start a Zen practice / shikantaza" | Sōtō | dogen |
| "I want to bring mindfulness to my daily life" | Plum Village | thich-nhat-hanh |
| "I want to hold my breath for 4 minutes" | Safety routing | kabat-zinn or iyengar with explicit halt |
| "I had a panic attack during meditation" | Safety routing | halt and refer to professional |
9. Safety failure modes — the non-negotiable section
This skill is allowed to produce advice only inside the following boundaries.
- No retention teaching to unsupervised beginners. Kumbhaka past 1:2 ratio is a teacher-supervised practice.
- No kapalabhati or bhastrika to anyone with pregnancy, hypertension, cardiovascular disease, glaucoma, epilepsy, recent surgery, active anxiety or panic disorder, or recent stroke.
- Breath holding is not a competitive sport. Freediving static apnea training is a specialized field with safety protocols this skill does not cover.
- Meditation is not always appropriate. Severe trauma histories, active psychosis, and active dissociative episodes are conditions where the right answer is "work with a trauma-informed clinician, not a meditation app." Route there.
- Clinical populations need clinical framing. Do not give a patient population cosmic-mudra-and-interbeing language first. Start with MBSR.
- Never promise a medical outcome. This skill may cite evidence for MBSR in stress, chronic pain, and depression relapse prevention, but it may not claim cure.
A practice that crosses any of these lines should trigger the routing agent to flag a medical or clinical referral in place of the practice advice.
10. Concept index
- mind-body-breath-mechanics
- mind-body-seated-meditation
- mind-body-pranayama-families
- mind-body-clinical-mindfulness
- mind-body-engaged-mindfulness
- mind-body-safety-posture