An intelligent workspace wellness tool that monitors active work sessions and prompts users to take regular, non-intrusive breaks.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install focus-break-reminder
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install focus-break-reminder using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Focus Break Reminder?
Focus Break Reminder is a sophisticated state-machine driven skill designed for Openclaw Skills to promote digital well-being. It tracks continuous work activity and calculates optimal moments for rest based on configurable parameters like work intervals, cooldowns, and idle time resets.
By integrating seamlessly into your coding environment, this skill ensures you maintain peak cognitive performance without the risk of burnout or physical strain during long development sessions. It avoids the pitfalls of traditional timers by using activity-based tracking, ensuring that reminders only trigger when you are actually working.
Focus Break Reminder Use Cases
- Managing long coding sessions where you lose track of time.
- Implementing a Pomodoro-style workflow directly within your AI agent interface.
- Preventing digital eye strain by following the 20-20-20 rule during intense tasks.
- Setting daily limits on work reminders to maintain a focused, non-intrusive workspace environment.
How Focus Break Reminder Works
- The skill monitors inbound user activity and updates the last active timestamp for each session.
- It calculates the active session duration and checks for idle periods that might trigger a session reset if the user has been away.
- The logic evaluates the current time against configured quiet hours, snooze status, and daily reminder caps.
- If the continuous work duration exceeds the limit and cooldown periods have passed, a reminder is delivered via a short, practical template.
- The state is persisted to a lightweight JSON file to ensure reminder consistency and daily counts survive agent restarts.
Focus Break Reminder Setup
To get started with this addition to your Openclaw Skills library, follow these steps:
- Load or create the configuration file at
references/config.example.jsonwith your preferred defaults. - Configure your essential settings including
work_minutes,cooldown_minutes, andquiet_hours. - Enable the skill by running the following command in your chat interface:
/break on
- Use the status command to verify your configuration and see the next eligible reminder window:
/break status
Focus Break Reminder Data Schema & Taxonomy
The skill maintains a minimal state per user to ensure performance and privacy. The following fields are tracked in the local JSON storage:
| Field | Description |
|---|---|
session_start_at |
Timestamp marking the beginning of the current active work block. |
last_active_at |
The most recent timestamp of user interaction or inbound message. |
last_remind_at |
Timestamp of the last break reminder successfully sent to the user. |
remind_count_today |
Counter for reminders sent within the current calendar day to enforce caps. |
snooze_until |
A specific timestamp used to suppress reminders until the snooze period expires. |
Focus Break Reminder Advanced Features
- Idle Reset Logic: Automatically restarts the work timer if the user is inactive for a specific duration, preventing false reminders.
- Heartbeat Polling: Uses intelligent polling to run eligibility checks during active periods while avoiding noisy, resource-heavy loops.
- Multi-Parameter Configuration: Offers granular control over daily caps, timezone-aware quiet hours, and customizable reminder templates.
- Dynamic Command Interface: Provides full manual control over the skill via a suite of
/breakslash commands for on-the-fly adjustments.
SKILL.md
Loading
Related Openclaw Skills
YT Meta - YouTube Metadata Extractor
A command-line utility for extracting comprehensive YouTube metadata, including video details, channel statistics, and comments, without requiring an API key.
XSS Scanner
Detect and fix XSS vulnerabilities in frontend code using the Openclaw Skills security suite.
X Algorithm Mastery
A comprehensive data-driven framework for mastering the X algorithm to maximize reach, engagement, and account growth.
Wiki Generator
An automated CLI tool that scans your source code to generate comprehensive, structured Markdown wikis and architectural documentation.
Clash VPN Management
A specialized skill for controlling Clash VPN proxy services to enable access to restricted websites and global resources.
Dressup Playable Maker
A specialized automation tool for generating interactive fashion-based playable advertisements for mobile gaming and ad networks.
Featured*
