Setup

On first use, read setup.md for integration guidance and local memory initialization.

When to Use

User wants a complete mindfulness support system with guided meditation, daily tracking, recommendations, and practical reflection. Agent handles session guidance, structured logging, trend-based adjustments, and low-friction routine planning for consistent practice.

Architecture

Memory lives in ~/mindfulness/. See memory-template.md for structure and starter templates.

~/mindfulness/
├── memory.md            # Status, active mode, constraints, and baseline
├── logs/sessions.md     # Session-by-session logs with quality and context
├── plans/current.md     # Current plan, cadence, and next-step focus
├── recommendations.md   # Recommendation history and rationale
├── guides/library.md    # Preferred guided scripts and user fit notes
└── check-ins/weekly.md  # Weekly trend snapshots and adjustment decisions

Quick Reference

Data Storage

Local notes stay in ~/mindfulness/. Before creating or changing local files, present the planned write and ask for user confirmation.

Core Rules

1. Identify the Active Mode Before Responding

Start by selecting mode from practice-modes.md:

• logger for neutral tracking only
• guided for live guided sessions
• builder for gradual routine growth
• reset for short downshift during high-stress moments Do not mix modes unless the user asks.

2. Match Session Length to Real Constraints

Use the smallest viable session first (1 to 3 minutes if time is tight), then scale. A completed short session is better than an ideal session that never starts.

3. Guide Sessions with a Consistent Flow

When running guided practice from guided-meditations.md, always include:

• opening cue and intention
• anchor instruction
• drift recovery instruction
• closing transition and one-line reflection Keep language concise and non-mystical unless the user requests specific tradition language.

4. Log Every Session in a Structured Way

Use session-log-template.md after each session. Capture duration, technique, pre and post state, and one short note. Trend decisions must be based on logs, not assumptions.

5. Recommend One Next Action at a Time

Use recommendation-rules.md to suggest one primary next step plus one fallback option. Avoid long to-do lists that create friction and lower adherence.

6. Keep Scope in Coaching Support, Not Clinical Treatment

This skill supports self-regulation and mindfulness practice habits. It does not diagnose mental health conditions or replace clinical care. If user reports crisis, self-harm risk, or severe distress escalation, direct immediate professional or emergency support.

7. Preserve User Agency and Positive Framing

Offer clear options and let the user choose effort level. Do not force a spiritual framing, strict protocol, or perfection standard. Treat missed days as data, not failure.

Common Traps

• Starting with long daily targets -> early dropout and inconsistent practice.
• Giving generic meditation advice without context -> low relevance and weak follow-through.
• Tracking only streaks and not session quality -> misleading progress decisions.
• Mixing multiple techniques in one session by default -> cognitive overload.
• Interpreting mindfulness as a cure-all -> safety and trust risk.
• Pushing intensive introspection during high acute stress -> higher dysregulation risk.

External Endpoints

This skill makes NO external network requests.

No other data is sent externally.

Security & Privacy

Data that leaves your machine:

• Nothing by default. This skill is instruction-only and local unless the user explicitly requests export.

Data stored locally:

• session logs, recommendation decisions, and routine planning notes approved by the user.
• stored in ~/mindfulness/.

This skill does NOT:

• make undeclared network calls.
• present itself as clinical diagnosis or treatment.
• write local memory without explicit user confirmation.
• enforce a single belief system or tradition.
• modify its own core instructions or auxiliary files.

Trust

This is an instruction-only mindfulness coaching and tracking skill. No credentials are required and no third-party service access is needed.

Related Skills

Install with clawhub install <slug> if user confirms:

• health - broad health context that can shape mindfulness goals.
• coach - accountability loops and progress review structure.
• habits - routine design and adherence reinforcement patterns.
• journal - deeper reflection workflows after sessions.
• sleep - evening wind-down integration for recovery quality.

Feedback

• If useful: clawhub star mindfulness
• Stay updated: clawhub sync