← Back to Skills Marketplace
harrylabsj

Focus Session Tracker

by haidong · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ✓ Security Clean
42
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install focus-session-tracker
Description
Structure deep-work focus sessions with time-boxing, session goals, progress notes, distraction logs, and end-of-session review — no app dependency.
README (SKILL.md)

Focus Session Tracker

Safety Boundary

This skill provides a lightweight framework for structuring focused work or study sessions. It is not a medical or therapeutic tool. It does not diagnose, treat, or manage attention-deficit disorders, anxiety, or any mental health condition. If you have persistent difficulty focusing that interferes with daily life, consult a qualified healthcare professional.

When to Use / When Not to Use

Use this skill when you want to:

  • Plan and execute a single deep-work or study session.
  • Capture distractions without acting on them immediately.
  • Review what helped or hindered your focus after a session.
  • Build a personal productivity ritual over time.

Do not use this skill to:

  • Self-diagnose or self-treat attention or cognitive issues.
  • Replace professional support for ADHD, anxiety, or related conditions.
  • Force unhealthy work hours or ignore physical needs (sleep, meals, breaks).

Session Preparation (2–3 minutes)

Before starting, answer:

  1. Session Goal — What is the one concrete outcome I want by the end?
  2. Time Box — How long will I work? (Suggested: 25–90 minutes)
  3. Environment Check — Phone away? Notifications off? Materials ready?
  4. Break Plan — What will I do when the session ends?

Distraction Log Protocol

Distractions will happen. The goal is to capture them without breaking flow.

Quick-Capture Format

Keep a scratch pad or digital note beside you. When a distraction arises:

  1. Label it — internal (thought, worry, idea) or external (noise, notification, interruption).
  2. Note one word — enough to remember it later.
  3. Return immediately — do not act on it until the session ends.

Example Distraction Log

Time (relative) Type Note Action After Session?
+12 min Internal Idea for email campaign Add to tomorrow's list
+28 min External Slack notification Check after 4 PM block
+41 min Internal Grocery list item Write it down at break

Session Templates

Template A: The Standard Block (50/10)

  • Work: 50 minutes
  • Break: 10 minutes
  • Best for: Tasks requiring sustained thinking (writing, coding, analysis)

Template B: The Sprint (25/5)

  • Work: 25 minutes
  • Break: 5 minutes
  • Best for: Starting difficult tasks, short bursts, building momentum

Template C: The Long Flow (90/20)

  • Work: 90 minutes
  • Break: 20 minutes
  • Best for: Deep creative work when you're already warmed up

Template D: The Variable Block

  • Work: Self-chosen duration (30–120 minutes)
  • Break: Proportional (roughly 1:5 ratio)
  • Best for: Experienced practitioners who know their own rhythms

During the Session

  • Work on the single goal defined at the start.
  • Use the distraction log for everything else.
  • If truly stuck for more than 5 minutes, pause and re-read the goal. Adjust if needed.
  • Stay hydrated and seated comfortably (see desk-ergonomic-checklist skill if needed).

End-of-Session Review (3–5 minutes)

Answer these questions before moving on:

  1. Goal Achievement — Did I complete what I set out to do? If not, what remains?
  2. Focus Quality — Rate 1–5. What pulled me away?
  3. Distraction Patterns — Were most distractions internal or external?
  4. Environment — What helped? (music, silence, location, time of day)
  5. Next Adjustment — One thing to change for the next session.

Weekly Pattern Review

After 5–10 sessions, look back:

  • What time of day do I focus best?
  • Which session length feels most sustainable?
  • What are my top 3 recurring distractions?
  • What environmental changes had the biggest impact?

Use these insights to refine your default template.

Common Pitfalls

Pitfall Fix
No clear goal Spend 2 minutes defining the outcome before starting
Skipping breaks Schedule the break before the session begins
Ignoring body signals Stand, stretch, or rest if pain or fatigue appears
Perfectionism about focus A "3 out of 5" session is still progress
Back-to-back sessions Insert at least a 10-minute reset between blocks

Integration with Other Skills

  • Pair with desk-ergonomic-checklist if you work long hours at a computer.
  • Pair with hydration-rhythm-coach to maintain energy during deep work.
  • Review weekly patterns in a personal journal or note system.

Differentiation: No app, timer, or tracking software required. Focuses on session-level structure, distraction capture, and reflective review rather than long-term habit tracking.

Usage Guidance
This skill appears safe to install as a simple productivity prompt. Use normal discretion if you choose to record personal distraction logs or reflections in your own notes.
Capability Analysis
Type: OpenClaw Skill Name: focus-session-tracker Version: 1.0.0 The skill is a document-only productivity framework designed to guide users through structured deep-work sessions. It contains no executable code, no network requests, and no instructions that attempt to exfiltrate data or bypass security boundaries. All content in SKILL.md and skill.json is strictly aligned with its stated purpose of time-boxing and distraction management.
Capability Assessment
Purpose & Capability
The stated purpose—structuring focus sessions, logging distractions, and reviewing progress—is consistently reflected in SKILL.md, skill.json, and ACCEPTANCE.md.
Instruction Scope
Instructions are limited to user-directed planning, reflection, and optional note-taking; there are no commands to override user intent, automate actions, or force tool use.
Install Mechanism
There is no install spec, no required binaries, no executable code, and metadata declares the skill as document-only.
Credentials
The skill does not request filesystem, network, credential, API, device, or account access.
Persistence & Privilege
The skill suggests user-managed notes or journaling but does not create persistent agent memory, background workers, credentials, or elevated permissions.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install focus-session-tracker
  3. After installation, invoke the skill by name or use /focus-session-tracker
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release of Focus Session Tracker — a lightweight framework for structured deep-work sessions without app or timer requirements. - Provides templates for time-boxed focus sessions (e.g., Pomodoro, Long Flow). - Includes protocols for logging distractions and reviewing session outcomes. - Emphasizes self-awareness, goal clarity, and post-session reflection. - Guidance on preparing environment, managing breaks, and addressing common pitfalls. - Safety boundaries: not for diagnosis or treatment of attention/mental health conditions.
Metadata
Slug focus-session-tracker
Version 1.0.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is Focus Session Tracker?

Structure deep-work focus sessions with time-boxing, session goals, progress notes, distraction logs, and end-of-session review — no app dependency. It is an AI Agent Skill for Claude Code / OpenClaw, with 42 downloads so far.

How do I install Focus Session Tracker?

Run "/install focus-session-tracker" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Focus Session Tracker free?

Yes, Focus Session Tracker is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Focus Session Tracker support?

Focus Session Tracker is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Focus Session Tracker?

It is built and maintained by haidong (@harrylabsj); the current version is v1.0.0.

💬 Comments