# Pomodoro Timer

> Launches an interactive Pomodoro timer (work/break cycle) with an animated circular countdown. Use when the user asks to start a Pomodoro, a focus session, a 25/5 timer, or any timed work/break interval.

- Skill: `jgouviergmail/pomodoro-timer` (Agent Skill, multi-file: 4 files)
- Install (CLI): `npx skillmds@latest add jgouviergmail/pomodoro-timer`
- Raw SKILL.md: https://api.skillmd.com/api/skills/jgouviergmail/pomodoro-timer/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: jgouviergmail (https://skillmd.com/u/jgouviergmail)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/jgouviergmail/pomodoro-timer

---


# Pomodoro Timer

## Instructions

This skill launches a self-contained interactive Pomodoro timer directly in
the chat. The plan is deterministic: the rendering script emits an HTML
frame with an animated SVG countdown, start/pause/reset controls, and an
automatic work→break transition.

Default cycle: 25 minutes of focus, followed by 5 minutes of break. The
user can override either duration in their query (e.g. "50/10 pomodoro"
or "minuteur de 15 minutes de travail"). The response LLM should detect
these overrides and pass ``work_minutes`` / ``break_minutes`` accordingly
when invoking the script.

## Output Contract

Returns ``text`` + ``frame.html``:

- ``text``: one-line caption announcing the timer.
- ``frame.html``: the inline interactive HTML (SVG + inline JS).

## Ressources disponibles

- scripts/render_timer.py — Generates the interactive Pomodoro HTML frame.