Pomodoro Focus Timer

What Problem It Solves

When a task is described only as “finish today,” starting work or study can quickly drift into procrastination, frequent context switching, and irregular breaks. pomodoro-focus-timer targets this by turning vague tasks into actionable Pomodoro rhythms instead of merely exposing a countdown timer.

How the Skill Works

It works around the input task and target duration:
- Interpret task type: decide whether the task fits continuous execution, staged decomposition, or a short validation loop first.
- Generate a Pomodoro plan: return pomodoroPlan.sessions[] with focus sessions, plus summary{} for total duration, break cadence, and completion expectations.
- Suggest timer settings: provide timer_settings{} for focus and break durations, and include a short message with execution guidance.

From a technical standpoint, the output is structured JSON, which makes it easier to integrate with schedulers, reminders, task boards, or agent workflows. The skill is closer to a planning layer: it converts task context into pacing rather than directly controlling a hardware timer.

Boundaries and Caveats

It suits study, writing, debugging, and planning work that can be chunked into 25/30/45 minute sessions; for tasks with real-time response, heavy collaboration, or non-interruptible delivery constraints, the Pomodoro cadence is only a reference. If the input lacks target duration or task boundaries, the output will rely more on defaults, so adding task context improves the plan.