pomodoro

Schedule focused work sessions with configurable Pomodoro timers and tracked cycles.

56|7|Updated Oct 21, 2025

Ready to run

npx skills add https://github.com/jakedahn/pomodoro --skill pomodoro

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: pomodoro
Source: https://github.com/jakedahn/pomodoro/tree/main/src
Command: npx skills add https://github.com/jakedahn/pomodoro --skill pomodoro

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides a focused, time-boxed work timer (Pomodoro) with automatic session tracking to help you work more efficiently and understand your productivity patterns over time.

Core Features & Use Cases

Session tracking: Each Pomodoro work period is saved to a local SQLite database, enabling history and analytics.
Productivity analytics: Review completion rates, total focus time, and peak working hours.
Use Case: When you want to optimize your day for deep work, start a Pomodoro session and later review history to identify tasks that benefit most from focused time.

Quick Start

Run the Pomodoro CLI to start a focused session, for example: ./pomodoro start --task "Write documentation" --work 25 --break 5 --cycles 4

Frequently Asked Questions about pomodoro

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How do I use the Pomodoro technique to improve focus and productivity?▼

The Pomodoro technique breaks work into focused time-boxed intervals (typically 25 minutes) followed by short breaks. This Skill implements timed work sessions with automatic tracking, helping you maintain concentration on tasks like coding, writing, or research while building awareness of your productivity patterns over time.

Can I track and analyze my work sessions across multiple Pomodoro cycles?▼

Yes. Each Pomodoro session is saved to a local SQLite database, enabling you to review completion rates, total focus time, and peak working hours. This history lets you identify which tasks and times benefit most from focused Pomodoro intervals.

How do I start a Pomodoro session with custom work and break durations?▼

Run the CLI with configurable parameters: specify your task name, work duration, break length, and number of cycles. For example, start a 25-minute work session with a 5-minute break and track your progress across multiple rounds.

What data does the Pomodoro timer store, and how is it persisted?▼

Session data—including task name, duration, completion status, and timestamps—is stored in a local SQLite database. This cross-session persistence enables ongoing analytics and historical review without data loss between sessions.

Can I use this Pomodoro timer for different types of work tasks?▼

Yes. This Skill applies to study, coding, writing, and research tasks where time-boxed intervals support deep work. You associate each session with a specific task, allowing you to track and optimize focus time across different project types.