Agent skill · operations · daffy0208
Focus Session Manager
Automatically manage focus sessions, breaks, and hyperfocus protection. Uses ADHD-optimized Pomodoro technique with flexible timers, health reminders, and gentle interruptions. Protects against hyperfocus burnout while maximizing productive time.
Why this skill is useful
Provides a unique session management system tailored for ADHD, including flexible timers and automated break reminders that aren't commonly found in standard productivity tools.
What it needs
Requires focus-session-manager installed locally. About 8k tokens when loaded. Last updated 2025-12-25. 33 stars on the source repository.
What this skill does
Focus Session Manager Protect your health. Maximize focus. Prevent burnout. Core Principle ADHD brains are prone to hyperfocus (ignoring breaks, health) and time blindness (losing track of time). The solution: Automated session management that tracks time, enforces breaks, and protects health without disrupting flow state. Key Insight: You can't manage time you can't see. Make time visible and automatic. --- The Focus Problem Problem 1: Hyperfocus Burnout Issue: Code for 4 hours straight without break Result: Exhaustion, health issues, reduced quality Problem 2: Time Blindness Issue: "I'll work for 30 min" → Actually 3 hours Result: Missed meetings, forgotten commitments, burnout Problem 3: Break Resistance Issue: "Just one more thing" never stops Result: No breaks, deteriorating health, reduced productivity Problem 4: Disrupted Flow Issue: Harsh timer interruptions break concentration Result: Frustration, ignoring timers, no break system --- Phase 1: Automatic Session Tracking Always-On Time Tracking Starts automatically when you begin coding: Visible Time Display Status bar shows: Session Types (Auto-Detected) Deep Work: Complex coding, architecture Duration: 45-90 minutes Break: 15 minutes Best for: New features, debugging Quick Tasks: Bug fixes, updates Duration: 25 minutes Break: 5 minutes Best for: Small fixes, reviews Learning: Reading docs, tutorials Duration: 30 minutes Break: 10 minutes Best for: New tech, research --- Phase 2: ADHD-Optimized Pomodoro Traditional Pomodoro (ADHD-Hostile) ❌ Rigid 25-min timer (might be mid-thought) ❌ Harsh interruption (breaks flow) ❌ Forced break (when you're in flow) ❌ No hyperfocus protection (ignores long sessions) ADHD-Friendly Pomodoro ✅ Flexible timers (25/45/90 min options) ✅ Gentle reminders (dismissable but persistent) ✅ Flow-aware breaks (suggests good stopping points) ✅ Hyperfocus detection (escalating alerts) Smart Break Timing --- Phase 3: Break Management Break Types Micro-Break (2 minutes): Look away from scr …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills daffy0208/focus-session-manager