← Back to Skills Marketplace
Meditation Guide
by
bytesagain3
· GitHub ↗
· v3.0.0
· MIT-0
528
Downloads
0
Stars
2
Active Installs
12
Versions
Install in OpenClaw
/install meditation-guide
Description
Guided meditation with breathing exercises and session tracking. Use when practicing mindfulness.
Usage Guidance
This skill appears to be what it says: local meditation tools and a simple session log in ~/.local/share/meditation-guide/sessions.jsonl. Before installing, you may want to: (1) inspect the two included scripts (scripts/script.sh and scripts/meditate.sh) to confirm you want both present — the Python script is not referenced by SKILL.md; (2) be aware the skill will create/append sessions.jsonl in your home; (3) if you prefer, run the scripts in a sandbox or check their behavior by running them manually to verify outputs. The scripts show some minor bugs (e.g., echo strings using single quotes preventing variable expansion) but nothing indicates malicious intent.
Capability Analysis
Type: OpenClaw Skill
Name: meditation-guide
Version: 3.0.0
The skill bundle contains a shell injection vulnerability in `scripts/script.sh` within the `cmd_start` function, where the user-provided input is concatenated into a command string without sanitization. Additionally, `scripts/script.sh` contains a large block of empty lines (lines 14–89), a common obfuscation technique used to hide code from quick inspection. While the primary logic in `scripts/meditate.sh` appears benign, the presence of these vulnerabilities and the redundant, poorly-secured implementation in the entry-point script are high-risk indicators.
Capability Assessment
Purpose & Capability
Name/description match the behavior in the provided scripts: breathing guides, timers, guides, journaling prompts, and simple session tracking. No unrelated credentials, binaries, or config paths are required.
Instruction Scope
SKILL.md invokes scripts/script.sh and documents the data directory (~/.local/share/meditation-guide). The scripts only read/write a sessions.jsonl in that directory and print guidance; they do not access external networks or other system credentials. Note: there is an extra script (scripts/meditate.sh) that implements similar functionality in Python but is not referenced by SKILL.md — this duplication is likely benign but unusual.
Install Mechanism
No install specification; this is an instruction-only skill with bundled scripts. Nothing is downloaded or written during installation beyond the scripts already in the bundle.
Credentials
The skill requests no environment variables or credentials. It uses $HOME for a local data directory, which is proportionate to session tracking.
Persistence & Privilege
The skill is not force-enabled (always: false) and does not modify other skills or global agent configuration. It persistently writes session entries to its own directory, which is expected for a tracker.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install meditation-guide - After installation, invoke the skill by name or use
/meditation-guide - Provide required inputs per the skill's parameter spec and get structured output
Version History
v3.0.0
v3.0.0: Complete rewrite.
v2.0.1
update
v2.0.0
v2.5 standard: Use-when desc, homepage, source, security fix
v2.3.6
yaml-fix+quality
v2.3.5
yaml-fix+quality
v2.3.4
Quality upgrade
v2.3.3
Quality upgrade: custom functionality
v2.3.2
Standards compliance: unique content, no template text
v2.3.1
Quality improvement: better docs, examples, cleaner text
v2.3.0
Quality fixes: removed third-party references, aligned docs with implementation
v2.2.0
Enhanced descriptions
v1.0.0
Initial release of Meditation Guide.
- Provides guided sessions for mindfulness, breathing exercises, body scan, sleep meditation, focus training, and meditation planning.
- Includes commands for different meditation types: mindful, breathe, body-scan, sleep, focus, and plan.
- Suitable for both beginners and experienced practitioners.
Metadata
Frequently Asked Questions
What is Meditation Guide?
Guided meditation with breathing exercises and session tracking. Use when practicing mindfulness. It is an AI Agent Skill for Claude Code / OpenClaw, with 528 downloads so far.
How do I install Meditation Guide?
Run "/install meditation-guide" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Meditation Guide free?
Yes, Meditation Guide is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Meditation Guide support?
Meditation Guide is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Meditation Guide?
It is built and maintained by bytesagain3 (@bytesagain3); the current version is v3.0.0.
More Skills