Pomodoro timer skill that remembers, learns, and improves over time. Operations teams use it to manage time blocks. Connects to CLI, SKILL.md, and a database for persistent state management.
git clone https://github.com/jakedahn/pomodoro.gitThe Pomodoro skill is a reference implementation of the System Skill Pattern designed for building Claude Skills that can remember, learn, and improve over time. This skill features a command-line interface (CLI) and a comprehensive SKILL.md documentation alongside a database, all demonstrated through a Pomodoro timer. By leveraging this skill, users can automate their productivity workflows, allowing for more efficient time management and task execution. One of the key benefits of the Pomodoro skill is its ability to enhance productivity by structuring work into focused intervals, typically 25 minutes, followed by short breaks. While the exact time savings are not quantified, the systematic approach to task management can lead to significant improvements in focus and efficiency. This skill is particularly beneficial for developers, product managers, and AI practitioners who often juggle multiple tasks and need a reliable method to maintain productivity without burnout. The Pomodoro skill is suitable for professionals across various roles, especially those involved in software development and project management. It can be integrated into daily workflows to help maintain concentration and manage time effectively. For instance, a developer might use the Pomodoro timer to break down coding tasks into manageable intervals, while a product manager could apply it to streamline meetings and planning sessions. By implementing this skill, teams can foster a culture of productivity and continuous improvement. With an intermediate implementation difficulty and an estimated setup time of around 30 minutes, the Pomodoro skill requires basic familiarity with command-line tools and workflow automation. As organizations increasingly adopt AI-first strategies, integrating such automation skills into daily operations can significantly enhance overall efficiency. The Pomodoro skill exemplifies how AI automation can transform traditional productivity methods into a more adaptive and intelligent approach.
["1. **Initialize the Timer:** Paste the prompt into your AI assistant (e.g., Claude/ChatGPT) with placeholders filled. Example: `Start a Pomodoro timer for 'Draft Q3 Sales Report' with a duration of 25 minutes.`","2. **Configure Integrations:** Ensure your [DATABASE_NAME] (e.g., SQLite, Notion, or Google Sheets) and [SKILL.md] file are set up to log sessions. For Sortd, specify the board name (e.g., \"Sales Operations\") where tasks are tracked.","3. **Customize Preferences:** Provide your [BREAK_PREFERENCES] (e.g., \"I prefer 5-minute breaks after 25-minute sessions and 10-minute breaks after 50-minute sessions\") to optimize suggestions.","4. **Review Output:** After each session, check the AI’s output for task updates, break suggestions, and next steps. Use the Sortd integration to drag tasks between lanes (e.g., \"In Progress\" to \"Done\").","5. **Iterate:** At the end of the day, review your [SKILL.md] file or database to analyze patterns (e.g., \"I’m most productive in the morning\" or \"Longer sessions work better for deep work\"). Adjust your [DURATION_MINUTES] or [BREAK_PREFERENCES] accordingly."]
No install command available. Check the GitHub repository for manual installation instructions.
git clone https://github.com/jakedahn/pomodoroCopy the install command above and run it in your terminal.
Launch Claude Code, Cursor, or your preferred AI coding agent.
Use the prompt template or examples below to test the skill.
Adapt the skill to your specific use case and workflow.
Start a Pomodoro timer for [TASK_NAME] with a duration of [DURATION_MINUTES] minutes. Track my progress in [DATABASE_NAME] and suggest an optimal break length based on my historical [BREAK_PREFERENCES]. After the timer ends, automatically log the session in [SKILL.md] and update my task status in [Sortd board name]. If I complete the task early, suggest the next high-priority task from my Sortd backlog.
### Pomodoro Session Logged: "Draft Q3 Sales Report" **Session Details:** - **Task:** Draft Q3 Sales Report (Priority: High) - **Duration:** 25 minutes (09:00 AM - 09:25 AM) - **Break Suggested:** 5 minutes (based on your historical preference for short breaks after 25-minute sessions) - **Database Update:** Session logged in `pomodoro_sessions.db` with productivity metrics: 87% focus rate, 3 interruptions logged. - **Sortd Integration:** Task status updated to "In Progress" in the "Q3 Reporting" board under the "Sales Operations" lane. **Next Steps:** 1. **Break Activity:** Step away from screen. Stretch or hydrate (AI suggests: "Did you know standing for 2 minutes boosts circulation by 20%?"). 2. **Post-Break:** Resume at 09:30 AM with the next task: "Review competitor pricing data" (Priority: Medium). 3. **Progress Tracking:** Your cumulative focus time for today is now 1.2 hours (Goal: 4 hours). **Historical Insight:** This is your 4th Pomodoro session today. Your average session duration has increased by 12% over the past week, suggesting improved concentration. Consider extending to 30-minute sessions for tasks requiring deeper focus. **Reminder:** Your next team standup is at 10:00 AM. Set a 10-minute buffer to review notes.
AI assistant built for thoughtful, nuanced conversation
Get more done every day with Microsoft Teams – powered by AI
Automate security compliance and monitor real-time security posture seamlessly.
Automate your spreadsheet tasks with AI power
Agentic AI Workflow platform
Connected workspace for docs, wikis, and projects
Take a free 3-minute scan and get personalized AI skill recommendations.
Take free scan