Back to Skills

meditate-guidance

pjt222
Updated 2 days ago
7 views
17
2
17
View on GitHub
Designaidesign

About

This skill guides users through a complete, structured meditation session, coaching on posture, breathwork, and techniques like shamatha and vipassana. It's designed for developers to integrate into applications for meditation practice, stress management, focus preparation, or grounding after intense experiences. The skill handles the entire flow from session preparation to integration and closing.

Quick Install

Claude Code

Recommended
Primary
npx skills add pjt222/agent-almanac -a claude-code
Plugin CommandAlternative
/plugin add https://github.com/pjt222/agent-almanac
Git CloneAlternative
git clone https://github.com/pjt222/agent-almanac.git ~/.claude/skills/meditate-guidance

Copy and paste this command in Claude Code to install this skill

Documentation

Meditate (Guidance)

Guide person through structured meditation session. Develops concentration, awareness, equanimity through progressive techniques. AI acts as experienced meditation instructor — assess person's needs, suggest modifications real-time, coach through difficulties.

When Use

  • Person wants to begin or deepen meditation practice + asks for instruction
  • Someone needs to prepare mind for focused work requiring sustained attention
  • Grounding needed before or after energy healing work (see heal-guidance)
  • Mental stillness training requested as preparation for remote viewing (see remote-viewing-guidance)
  • Someone managing stress, anxiety, or emotional turbulence + wants guided support
  • Integration after wilderness immersion or intense experiences

Inputs

  • Required: Available time for session (minimum 10 minutes, recommended 20-45 minutes)
  • Required: Person has space where they will not be interrupted
  • Optional: Technique preference (shamatha, vipassana, mantra; default: shamatha)
  • Optional: Experience level (beginner, intermediate, advanced; default: beginner)
  • Optional: Timer or bell available (phone timer acceptable; suggest gentle tone)

Steps

Step 1: Guide Space Preparation

Help person choose + prepare location supporting stillness.

  1. "Find quiet area — indoors or outdoors, sheltered from wind"
  2. "Temperature should be comfortable — slightly cool better than warm for staying alert"
  3. "Dim harsh lighting or position yourself away from bright light"
  4. "Silence devices, or set single gentle timer for session length"
  5. If outdoors: "Sit on stable surface away from insect activity — raised log, flat rock, or folded cloth works well"

Got: Quiet, stable environment where person can sit undisturbed for planned session length.

If fail: No quiet space available? Suggest earplugs or accepting ambient sound as part of practice. Note outdoor sounds (wind, birds, water) can serve as meditation objects. Key requirement: no physical interruption.

Step 2: Coach Posture

Guide person into posture balancing alertness with relaxation.

Posture Selection Guide:
┌────────────────┬──────────────────────────┬───────────────────────────┐
│ Posture        │ Best For                 │ Setup                     │
├────────────────┼──────────────────────────┼───────────────────────────┤
│ Cross-legged   │ Experienced sitters,     │ Sit on cushion or folded  │
│ (Burmese/lotus)│ longer sessions          │ blanket, hips above knees,│
│                │                          │ hands on knees or in lap  │
├────────────────┼──────────────────────────┼───────────────────────────┤
│ Kneeling       │ Those with tight hips,   │ Kneel on cushion or bench,│
│ (seiza)        │ moderate sessions        │ weight on shins not knees │
├────────────────┼──────────────────────────┼───────────────────────────┤
│ Chair          │ Beginners, limited       │ Feet flat on floor, back  │
│                │ flexibility, injury      │ away from chair back,     │
│                │                          │ hands on thighs           │
├────────────────┼──────────────────────────┼───────────────────────────┤
│ Standing       │ Drowsiness, very short   │ Feet shoulder-width,      │
│                │ sessions, walking warmup │ slight knee bend, hands   │
│                │                          │ at sides or clasped       │
└────────────────┴──────────────────────────┴───────────────────────────┘

Walk through alignment checklist:

  1. "Tilt hips slightly forward to support spine's natural curve"
  2. "Stack spine — imagine string pulling crown of head toward sky"
  3. "Let shoulders relax + roll slightly back"
  4. "Tuck chin slightly — lengthen back of neck"
  5. "Softly close eyes, or let them rest half-open with downward gaze"
  6. "Unclench jaw, rest tongue on roof of mouth"
  7. "Find comfortable hand position — palms down on knees, or cupped in lap"

Got: Stable posture person can maintain without significant discomfort for planned session length. Appears alert but not tense.

If fail: Pain develops within first 5 minutes? Guide adjustment. Reassure pain is not the practice — suggest switching to more supported posture. Mention leg numbness during longer sits is normal + passes, but shift if becomes strong distraction.

Step 3: Guide Breath Anchoring

Establish breath as primary meditation object.

  1. "Take 3 deep breaths to transition — inhale fully, exhale completely with sigh"
  2. "Now let breath return to natural rhythm — don't try to control"
  3. "Choose where you'll feel breath: nostrils, chest, or belly"
  4. "Place full attention on that spot"
  5. "Notice each breath — beginning of inhale, middle, end; pause; beginning of exhale, middle, end"
  6. If helpful: "Silently count breaths — 1 on inhale, 2 on exhale, up to 10, then restart"

Got: Attention rests on breath for several consecutive cycles. Mind begins to settle. Thoughts still arise but awareness of breath underneath.

If fail: Mind scatters immediately? Suggest shorter count cycle (to 5 instead of 10). Counting feels mechanical? Offer alternative of simply noting "in" + "out" silently. Reassure even 3 consecutive attended breaths is strong start for beginners.

Step 4: Coach Distraction Handling

When person reports distraction, normalize + provide tools.

Handling Mental Activity:
┌────────────────────┬──────────────────────────────────────────────┐
│ Distraction Type   │ Coaching Response                            │
├────────────────────┼──────────────────────────────────────────────┤
│ Thought stream     │ "Silently label it 'thinking' and return to │
│ (planning, memory) │ the breath. Don't follow the narrative."     │
├────────────────────┼──────────────────────────────────────────────┤
│ Emotion            │ "Name the emotion — 'anger', 'sadness',     │
│ (anger, sadness,   │ 'joy'. Notice where it lives in the body.   │
│ excitement)        │ Let it be without suppressing or indulging." │
├────────────────────┼──────────────────────────────────────────────┤
│ Physical sensation │ "Note it — 'itching', 'warmth', 'pressure'. │
│ (itch, pain, temp) │ Observe without reacting for 30 seconds.    │
│                    │ Most sensations pass. Adjust only if needed."│
├────────────────────┼──────────────────────────────────────────────┤
│ Drowsiness         │ "Open your eyes wider, straighten your      │
│                    │ spine, take 3 sharp breaths. If it persists, │
│                    │ switch to standing or walking."              │
├────────────────────┼──────────────────────────────────────────────┤
│ Restlessness       │ "Acknowledge the energy without acting.      │
│                    │ Feel it as raw sensation in the body. If     │
│                    │ extreme, do 1 minute of deep breathing."     │
└────────────────────┴──────────────────────────────────────────────┘

Emphasize: "Moment you notice you've wandered IS moment of mindfulness. Each return to breath strengthens concentration. Self-criticism about wandering is just another thought to label + release."

Got: Over session, person reports decreasing frequency of wandering + faster noticing. Gap between wandering + noticing narrows.

If fail: Frustration builds? Soften approach: "Instead of concentrating hard, try simply being with breath — like sitting by river, not trying to control water." If thought or emotion overwhelming, suggest using as temporary meditation object, then return to breath when passes.

Step 5: Guide Shamatha (Calm Abiding)

Shamatha develops single-pointed concentration. Recommend for all levels.

  1. "Continue breath awareness from before"
  2. "Gradually narrow focus — from general sense of breathing to precise sensation at nostrils"
  3. "Notice subtlest details: temperature of air in vs out, tiny pause between breaths"
  4. When concentration stabilizes: "Release counting + rest in bare awareness of breath"
  5. "If mind becomes very still, notice that stillness itself — beginning of deeper concentration"

Suggest session timing by level:

  • Beginner: 10-15 minutes at Steps 3-5
  • Intermediate: 20-30 minutes, aim for extended unwavering attention
  • Advanced: 30-60 minutes, cultivate absorption states

Got: Progressively calmer + more focused mind. Thoughts slow. Awareness of present moment sharpens. Body feels settled + relaxed.

If fail: Concentration not deepening? Check three things with person: posture (slumping reduces alertness), breath (unconsciously controlling — suggest releasing control), expectation (wanting stillness is itself distraction). Reassure concentration develops over weeks + months, not within single session.

Step 6: Guide Vipassana (Insight) — If Appropriate

Only suggest vipassana after shamatha concentration reasonably stable. Ask person about experience before proceeding.

  1. "From this settled state, widen awareness beyond breath to include all sensations"
  2. "Observe whatever arises — sound, body sensation, thought, emotion — without preference"
  3. Introduce three characteristics:
    • "Notice impermanence: every sensation arises + passes away"
    • "Notice unsatisfactoriness: clinging to pleasant or resisting unpleasant creates tension"
    • "Notice non-self: sensations arise on their own; no controller making them happen"
  4. "Practice noting: silently label each experience — 'hearing', 'tingling', 'thinking', 'pleasant'"
  5. "Maintain equal interest in pleasant + unpleasant experiences"
  6. "If you feel agitated or destabilized, return to breath + shamatha"

Got: Moments of clear seeing where arising + passing of phenomena observed directly. Sense of spaciousness. Reduced identification with thought content.

If fail: Vipassana feels destabilizing (rapid emotional shifts, anxiety, disorientation)? Guide immediate return to shamatha + breath anchoring. Note insight practice can temporarily amplify difficult mind states — recognized in traditional practice, best navigated with ongoing teacher support for advanced stages.

Step 7: Close Session

Guide proper closing integrating session + transitioning back to activity.

  1. When timer signals: "Don't stand up yet"
  2. "Take 3 deep, intentional breaths"
  3. "Gradually widen awareness — from breath to body, to sounds around you, to space you're in"
  4. "Gently move fingers + toes, rotate wrists + ankles"
  5. "If eyes were closed, open them slowly — look down first, then gradually look up"
  6. "Sit for another minute or two in open awareness — not meditating, not yet active"
  7. "Notice: what was quality of this session? What did you observe? No judgment — just noting"
  8. "Set intention for carrying this mindful awareness into next activity"

Got: Smooth transition from meditative state to activity. Residual calm + clarity persist. No grogginess or disorientation.

If fail: Feel groggy? Suggest 5 sharp breaths + stretching before standing. Session surfaced unresolved emotion? Offer brief journaling or walking meditation before resuming tasks. Body stiff? Guide gentle stretching for 2-3 minutes.

Checks

  • Space prepared, interruptions prevented
  • Posture coached for both alertness + comfort
  • Breath established as primary anchor before deepening
  • Distractions met with labeling + return, not suppression
  • Technique matched person's experience level (shamatha first, vipassana only if stable)
  • Session closed with gradual transition, not abrupt stop
  • Post-session state calm + alert
  • AI coached without claiming personal meditative experience

Pitfalls

  • Overcomplicating instruction: Keep guidance minimal during session — too much talk disrupts practice
  • Pushing advanced techniques too early: Vipassana without shamatha foundation can be destabilizing — assess readiness honestly
  • Judging person's progress: "Good" + "bad" sessions are both practice — normalize difficulty
  • Neglecting posture: Poor posture guarantees physical distraction within minutes — invest time in setup
  • Inconsistent encouragement: One guided session per week less effective than daily self-practice — encourage regularity over duration
  • AI over-talking: Once person settled, reduce guidance to brief check-ins. Silence is part of instruction.

See Also

  • meditate — AI self-directed variant for meta-cognitive reflection + reasoning pattern observation
  • heal-guidance — meditation builds focused presence needed for guided healing work
  • remote-viewing-guidance — CRV requires mental stillness cultivated in shamatha practice
  • mindfulness — defensive situational awareness applies meditative attention to real-world environments
  • tai-chi — moving meditation practice building on stillness developed here
  • forage-plants — wilderness foraging with mindful awareness deepens both practices
  • make-fire — fire-gazing can serve as meditation object in wilderness settings

GitHub Repository

pjt222/agent-almanac
Path: i18n/caveman/skills/meditate-guidance
0
agentsagentskillsai-assisted-developmentclaude-codeskillsteams

Related Skills

executing-plans

Design

Use the executing-plans skill when you have a complete implementation plan to execute in controlled batches with review checkpoints. It loads and critically reviews the plan, then executes tasks in small batches (default 3 tasks) while reporting progress between each batch for architect review. This ensures systematic implementation with built-in quality control checkpoints.

View skill

requesting-code-review

Design

This skill dispatches a code-reviewer subagent to analyze code changes against requirements before proceeding. It should be used after completing tasks, implementing major features, or before merging to main. The review helps catch issues early by comparing the current implementation with the original plan.

View skill

connect-mcp-server

Design

This skill provides a comprehensive guide for developers to connect MCP servers to Claude Code using HTTP, stdio, or SSE transports. It covers installation, configuration, authentication, and security for integrating external services like GitHub, Notion, and custom APIs. Use it when setting up MCP integrations, configuring external tools, or working with Claude's Model Context Protocol.

View skill

web-cli-teleport

Design

This skill helps developers choose between Claude Code Web and CLI interfaces based on task analysis, then enables seamless session teleportation between these environments. It optimizes workflow by managing session state and context when switching between web, CLI, or mobile. Use it for complex projects requiring different tools at various stages.

View skill