← Back to Skills Marketplace
PomoClaw
by
Vladimir Kozlovskyi
· GitHub ↗
· v1.0.0
485
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install pomoclaw
Description
Control the PomoClaw pomodoro timer on the Mac. Use when the user asks to start, stop, pause a pomodoro/pomoclaw/focus timer, check timer status, or when a p...
Usage Guidance
This skill appears coherent for controlling a macOS menu‑bar pomodoro app, but verify a few practical things before installing: (1) Confirm you have the PomoClaw app installed from the referenced GitHub releases and trust that source. (2) Ensure the agent will run commands on a macOS node (the SKILL.md relies on the macOS `open` command) — the registry entry does not declare an OS restriction. (3) Understand the skill will read ~/.pomoclaw/status.json after a status call; inspect that file for any sensitive info and confirm its permissions. (4) If you want to avoid accidental autonomous use, keep the skill user-invocable only (default) or restrict agent invocation policies. (5) If you need greater assurance, review the app binary/source on the GitHub repo before use.
Capability Analysis
Type: OpenClaw Skill
Name: pomoclaw
Version: 1.0.0
The skill is classified as suspicious because its `SKILL.md` instructions explicitly direct the AI agent to execute shell commands using `bash -c` and read local files using `cat`. While these actions are intended for benign purposes (controlling a pomodoro timer via URL scheme and reading its status file), they expose the agent to powerful primitives that could be exploited via prompt injection by a malicious user to execute arbitrary commands or read sensitive files beyond the skill's stated purpose. There is no evidence of intentional malicious behavior within the skill itself, but it demonstrates and enables risky capabilities for the agent.
Capability Assessment
Purpose & Capability
Name/description match the instructions: controlling a macOS app via the pomoclaw:// URL scheme. Minor mismatch: the skill is macOS-specific (uses the open command and a menu‑bar app) but the registry metadata does not declare an OS restriction.
Instruction Scope
SKILL.md only instructs the agent to invoke macOS URL-scheme commands (open 'pomoclaw://...') and to read the app's status file (~/.pomoclaw/status.json) after using the status command. There are no instructions to read unrelated files, send data to external endpoints, or access unrelated environment variables.
Install Mechanism
Instruction-only skill with no install spec or downloaded artifacts. Lowest-risk model for install behavior.
Credentials
No environment variables, credentials, or config paths are requested beyond the single app-specific status file (~/.pomoclaw/status.json) which is referenced explicitly and consistently with the stated purpose.
Persistence & Privilege
Skill is not marked always:true and uses default autonomous invocation settings; nothing indicates elevated or persistent privileges beyond normal agent skill behavior.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install pomoclaw - After installation, invoke the skill by name or use
/pomoclaw - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
PomoClaw skill version 1.0.0 initial release:
- Adds support for controlling the PomoClaw pomodoro timer on Mac via URL scheme commands.
- Handles start, stop, pause, resume, status check, and break for both work and break timers.
- Provides a unified configuration command for customizing work/break durations, sounds, and launch options.
- Supports checking timer status from a JSON file.
- Responds to "Pomodoro finished" system events/webhooks.
- Designed for easy integration with OpenClaw and scripted automation on macOS.
Metadata
Frequently Asked Questions
What is PomoClaw?
Control the PomoClaw pomodoro timer on the Mac. Use when the user asks to start, stop, pause a pomodoro/pomoclaw/focus timer, check timer status, or when a p... It is an AI Agent Skill for Claude Code / OpenClaw, with 485 downloads so far.
How do I install PomoClaw?
Run "/install pomoclaw" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is PomoClaw free?
Yes, PomoClaw is completely free (open-source). You can download, install and use it at no cost.
Which platforms does PomoClaw support?
PomoClaw is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created PomoClaw?
It is built and maintained by Vladimir Kozlovskyi (@vkozlovskyi); the current version is v1.0.0.
More Skills