Where is my break history stored?

Your sessions are logged in a structured JSONL format located at .codex/skills/_state/session_log.jsonl within your project directory.

Can this skill help with the Pomodoro technique?

Yes, by tracking 'time worked' and suggesting structured intervals, it functions as a context-aware Pomodoro assistant integrated directly into your terminal.

How does the skill calculate suggested break times?

The skill uses a tiered guideline: 5 minutes for work under 25 minutes, 10 minutes for 25-50 minutes, up to 30 minutes for deep work sessions exceeding 90 minutes.

How do I signal that I am back from a break?

Simply tell Claude 'I'm back' or 'back'. The skill will log the end of the break, calculate the duration, and prompt you with your next task.

What is a 'return intention'?

It is a specific, small task captured before you leave (e.g., 'Update slide 6') that Claude reminds you of when you return, helping you re-enter flow state instantly.

Smart Break & Focus Manager

Name: Smart Break & Focus Manager
Author: maciejjankowski

bymaciejjankowski

0•

Productivity & Workflow

Logs work breaks, suggests optimal rest durations, and establishes clear return intentions to maintain a healthy and productive coding rhythm.

The Smart Break & Focus Manager is a productivity-focused skill designed to combat developer fatigue and preserve mental momentum. By monitoring active work periods, the skill suggests appropriate break lengths based on time-on-task and encourages healthy habits like physical movement and eye rest. Its most powerful feature is 'return intention' setting, which captures the immediate next step before a user steps away, effectively eliminating the 're-entry friction' commonly experienced when resuming complex coding tasks.

Key Features

01Context-aware break duration suggestions based on work intensity

02Automated session logging for work-rest ratio tracking

030 GitHub stars

04Seamless 'Resume' prompts with specific, actionable next steps

05Return intention capture to maintain task momentum

06Wellness reminders to promote physical movement over digital distractions

Use Cases

01Maintaining project context when stepping away for meetings or meals

02Preventing burnout during long-duration deep work or debugging sessions

03Auditing work habits using the persistent session log state

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add maciejjankowski/dtc-compass break

For use in Claude.ai and ChatGPT

Download Skill