pomodoro

The Pomodoro System Skill is a specialized tool designed for knowledge workers, developers, and researchers who want to cultivate deep work habits through the Pomodoro technique. By integrating a command-line interface with a local SQLite database, it transforms standard time-tracking into a persistent, evolving productivity system. The skill operates on the OODA loop mental model—Observe, Orient, Decide, and Act—allowing the agent to review your work history, analyze patterns in your focus duration, and provide actionable recommendations to optimize your daily schedule based on historical performance data.

• Automatically logs every work session, including duration, completion status, and task description.

• Generates comprehensive productivity analytics, such as session completion rates, total focus hours, and peak productivity windows throughout the day.

• Supports custom session configurations, including configurable work intervals, break durations, and multi-cycle repetition for intense tasks like flashcard reviews or deep code refactoring.

• Offers seamless JSON output options for programmatic integration, making it compatible with other automated workflows or dashboarding tools.

• Built as a System Skill, it is designed to build context over time; the more you use it, the more intelligent the agent becomes in identifying your optimal deep work times and task-completion patterns.

• Operates entirely locally with no external dependencies or cloud monitoring, ensuring data privacy and offline functionality.

• Designed for macOS/Apple Silicon environments with a straightforward CLI that provides clear feedback on status, elapsed time, and session progress.

• Requires minimal setup: initialized automatically upon the first execution with a lightweight database schema optimized for fast retrieval and time-based aggregation.

• Best utilized when asking questions like 'How productive was I this week?', 'What are my best working hours?', or when initiating specific focus blocks for coding or writing.

• Effectively bridges the gap between simple manual timers and complex project management software by providing a low-friction, data-driven approach to personal time management.