← Back to Skills Marketplace
theshadowrose

FocusTimer Pomodoro Timer via Agent

by Shadow Rose · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ✓ Security Clean
655
Downloads
0
Stars
1
Active Installs
1
Versions
Install in OpenClaw
/install focus-timer
Description
Pomodoro-style focus blocks managed by your agent. Start, pause, track sessions. Daily focus time reports. No app needed, just chat.
README (SKILL.md)

FocusTimer Pomodoro Timer via Agent

Pomodoro-style focus blocks managed by your agent. Start, pause, track sessions. Daily focus time reports. No app needed, just chat.

Your agent manages your focus blocks. No timer app needed.

Usage

You: "Start a focus block — working on the API redesign"
Agent: "🍅 Focus started: API redesign. 25 minutes."

[25 minutes later]

Agent: "⏰ Done! 25 min on API redesign. 3 blocks today (1h 15m total). 
        Take a 5-min break. Ready for another?"

Features

  • Conversational control — start, pause, skip break
  • Session tracking — what, how long, when
  • Daily reports — total focus time, blocks, topics
  • Weekly trends — "12 hours this week, up from 9"
  • Task tagging — time per project
  • Break reminders — nudge to actually rest

Configuration

focus_duration: 25
short_break: 5
long_break: 15    # every 4 blocks
daily_goal: 8     # blocks

Daily Report

🍅 Focus Report — Feb 28
Blocks: 6/8 (75%)
Total: 2h 30m
Topics: API redesign (3), docs (2), email (1)
Peak: 9:00-11:30 AM

⚠️ Disclaimer

This software is provided "AS IS", without warranty of any kind, express or implied.

USE AT YOUR OWN RISK.

  • The author(s) are NOT liable for any damages, losses, or consequences arising from the use or misuse of this software — including but not limited to financial loss, data loss, security breaches, business interruption, or any indirect/consequential damages.
  • This software does NOT constitute financial, legal, trading, or professional advice.
  • Users are solely responsible for evaluating whether this software is suitable for their use case, environment, and risk tolerance.
  • No guarantee is made regarding accuracy, reliability, completeness, or fitness for any particular purpose.
  • The author(s) are not responsible for how third parties use, modify, or distribute this software after purchase.

By downloading, installing, or using this software, you acknowledge that you have read this disclaimer and agree to use the software entirely at your own risk.

DATA DISCLAIMER: This software processes and stores data locally on your system. The author(s) are not responsible for data loss, corruption, or unauthorized access resulting from software bugs, system failures, or user error. Always maintain independent backups of important data. This software does not transmit data externally unless explicitly configured by the user.

Support & Links
🐛 Bug Reports [email protected]
☕ Ko-fi ko-fi.com/theshadowrose
🛒 Gumroad shadowyrose.gumroad.com
🐦 Twitter @TheShadowyRose
🐙 GitHub github.com/TheShadowRose
🧠 PromptBase promptbase.com/profile/shadowrose

Built with OpenClaw — thank you for making this possible.

🛠️ Need something custom? Custom OpenClaw agents & skills starting at $500. If you can describe it, I can build it. → Hire me on Fiverr

Usage Guidance
This skill appears coherent and self-contained. Before installing, note that it will create and update a local file (./focus-data.json) in the agent's working directory — confirm that location is acceptable and that file permissions meet your privacy needs. The code swallows file-write errors (silent failures), so important data may be lost if the agent cannot write to that path. If you plan to run the agent in a multi-tenant environment, consider changing the dataFile path, restricting file permissions, or reviewing the source to add encryption or explicit error handling. If you require networked syncing or backups, implement/inspect that yourself — this package does not perform external transmission by default.
Capability Analysis
Type: OpenClaw Skill Name: focus-timer Version: 1.0.0 The FocusTimer skill is a standard Pomodoro implementation that manages session tracking and reporting. The code in src/focus-timer.js uses local file I/O (focus-data.json) for persistence but contains no network requests, shell command execution, or access to sensitive system files. The SKILL.md and README.md files provide clear instructions for the agent without any evidence of prompt injection or malicious intent.
Capability Assessment
✓ Purpose & Capability
Name/description (Pomodoro timer, session tracking, reports) align with the included code and SKILL.md. The code implements starting, checking, completing sessions, daily reports, and task tagging — all consistent with the stated purpose. No unrelated capabilities (cloud access, external services) are requested.
✓ Instruction Scope
SKILL.md instructs conversational control and local storage only. It disclaims that data is stored locally. The runtime code reads/writes a local JSON file (default './focus-data.json') and does not access other system files or environment variables. Note: the skill writes to the filesystem and needs write permission in the agent's working directory.
✓ Install Mechanism
No install spec is provided (instruction-only skill with a small JS file). No downloads or external install steps are present, which minimizes installation risk.
✓ Credentials
No environment variables, credentials, or config paths are required. The only resource used is a local data file (by default './focus-data.json'), which is proportionate for session persistence.
✓ Persistence & Privilege
always is false and model invocation is normal. The skill persists only its own session data to a local file and does not modify other skills or global agent settings.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install focus-timer
  3. After installation, invoke the skill by name or use /focus-timer
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial upload
Metadata
Slug focus-timer
Version 1.0.0
License MIT-0
All-time Installs 1
Active Installs 1
Total Versions 1
Frequently Asked Questions

What is FocusTimer Pomodoro Timer via Agent?

Pomodoro-style focus blocks managed by your agent. Start, pause, track sessions. Daily focus time reports. No app needed, just chat. It is an AI Agent Skill for Claude Code / OpenClaw, with 655 downloads so far.

How do I install FocusTimer Pomodoro Timer via Agent?

Run "/install focus-timer" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is FocusTimer Pomodoro Timer via Agent free?

Yes, FocusTimer Pomodoro Timer via Agent is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does FocusTimer Pomodoro Timer via Agent support?

FocusTimer Pomodoro Timer via Agent is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created FocusTimer Pomodoro Timer via Agent?

It is built and maintained by Shadow Rose (@theshadowrose); the current version is v1.0.0.

More Skills
self-improving agent
Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Clau...
⬇ 463283 · by pskoett
Skill Vetter
Security-first skill vetting for AI agents. Use before installing any skill from ClawdHub, GitHub, or other sources. Checks for red flags, permission scope, and suspicious patterns.
⬇ 259410 · by spclaudehome
Polymarket
Query Polymarket prediction markets. Check odds, find trending markets, search events, track price movements.
⬇ 232503 · by joelchance
Self-Improving + Proactive Agent
Self-reflection + Self-criticism + Self-learning + Self-organizing memory. Agent evaluates its own work, catches mistakes, and improves permanently. Use when...
⬇ 200423 · by ivangdavila
Github
Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries.
⬇ 191115 · by steipete
ontology
Typed knowledge graph for structured agent memory and composable skills. Use when creating/querying entities (Person, Project, Task, Event, Document), linkin...
⬇ 190156 · by oswalpalash

💬 Comments