mindfulness_skill

Overview

This skill provides a compact mindfulness system for tracking habits, running guided meditations, and growing calm focus through adaptive routines and reflective logs. It combines short, context-aware practices with structured logging and single-step recommendations to improve consistency without friction.

How this skill works

The skill keeps local memory under ~/mindfulness/ and stores session logs, plans, recommendations, and guides. Before writing files it presents proposed changes and asks for confirmation. It selects an active mode (logger, guided, builder, or reset) and follows clear rules for session length, flow, and single-step recommendations.

When to use it

• You want a low-friction daily mindfulness routine that adapts to real constraints.
• You need short guided sessions (1–20 minutes) with concise, non-mystical language.
• You want structured session logs to track quality, context, and trends.
• You need one clear next step rather than long to-do lists to prevent drop-off.
• You want local-only storage and no network data sharing by default.

Best practices

• Always confirm before the skill writes or changes local files in ~/mindfulness/.
• Start with the smallest viable session (1–3 minutes) when time is limited.
• Pick the single most useful next action and one fallback to reduce friction.
• Log every session with duration, technique, pre/post state, and one note.
• Use weekly trend snapshots to adjust cadence rather than relying on streaks alone.

Example use cases

• Run a focused 3-minute reset during a high-stress work break and log the outcome.
• Build a gradual morning routine with weekly plan updates and a single incremental goal.
• Track session quality over a month and receive one recommendation based on trends.
• Run a guided 10-minute breath-anchored practice using the guided scripts library.
• Use reflection prompts after sessions to integrate practice into daily behavior.