KS
Killer-Skills

focus — how to use focus skill how to use focus skill, focus skill setup guide, what is focus skill, focus vs task management tools, focus alternative for AI agents, focus install for developers, focus skill for sustained attention, json state file management, iso timestamp task tracking

v1.0.0
GitHub

About this Skill

Ideal for Task Management Agents requiring sustained attention and project organization capabilities. Focus is a task management skill that allows AI agents to set and manage current tasks, utilizing a JSON state file for data storage

Features

Reads and writes focus state to a `.codex/skills/_state/current_focus.json` file
Utilizes a JSON schema for task data, including task name, start time, and time estimate
Supports the creation of subtasks for breaking down larger tasks
Manages task context with a dedicated string field
Uses ISO timestamps for accurate task start time tracking

# Core Topics

maciejjankowski maciejjankowski
[0]
[0]
Updated: 3/6/2026

Quality Score

Top 5%
36
Excellent
Based on code quality & docs
Installation
SYS Universal Install (Auto-Detect)
Cursor IDE Windsurf IDE VS Code IDE
> npx killer-skills add maciejjankowski/dtc-compass/focus

Agent Capability Analysis

The focus MCP Server by maciejjankowski is an open-source Categories.community integration for Claude and other AI agents, enabling seamless task automation and capability expansion. Optimized for how to use focus skill, focus skill setup guide, what is focus skill.

Ideal Agent Persona

Ideal for Task Management Agents requiring sustained attention and project organization capabilities.

Core Value

Empowers agents to manage complex projects by reading and writing focus state to a JSON file, utilizing ISO timestamps and supporting task contextualization with subtasks, all while estimating time requirements in minutes.

Capabilities Granted for focus MCP Server

Setting and tracking current tasks with JSON state files
Automating focus state updates with ISO timestamp tracking
Breaking down large projects into smaller, manageable subtasks

! Prerequisites & Limits

  • Requires filesystem access to read and write .codex/skills/_state/current_focus.json
  • JSON file format adherence necessary for state management
Project
SKILL.md
1.9 KB
.cursorrules
1.2 KB
package.json
240 B
Ready
UTF-8

# Tags

[No tags]
SKILL.md
Readonly

Focus - Set Current Task

Manage the current focus task to support sustained attention.

State File

Read and write focus state to: .codex/skills/_state/current_focus.json

Schema:

json
1{ 2 "task": "string - what we're working on", 3 "started_at": "ISO timestamp", 4 "time_estimate_minutes": "number or null", 5 "context": "string - any relevant context", 6 "subtasks": ["list of smaller steps if broken down"] 7}

Setting Focus

When user sets a new focus:

  1. Read current state from .codex/skills/_state/current_focus.json
  2. If there was a previous focus, acknowledge it briefly ("Switching from X")
  3. Write new focus with:
    • task: what they said
    • started_at: current ISO timestamp
    • time_estimate_minutes: if they mentioned time, otherwise null
    • context: any relevant details
  4. Confirm with a brief, action-oriented message:
    • State the focus task clearly
    • If time estimate given, note it
    • Give the first concrete step if the task is vague

Checking Focus

When user asks "what am I working on" or seems lost:

  1. Read .codex/skills/_state/current_focus.json
  2. If no focus set: suggest setting one
  3. If focus exists:
    • State the task
    • Calculate time elapsed since started_at
    • Remind of any subtasks
    • Suggest next action

Tangent Detection

When user brings up something unrelated to current focus:

  1. Politely note this seems like a tangent
  2. Suggest using the tangent skill to capture it for later
  3. Redirect back to the current focus task

Do not lecture. Do not ask questions. State what we're doing and move forward.

Example Responses

Setting focus:

Focus set: Write Q1 roadmap document

Time estimate: 45 minutes
Started: now

First step: Open the roadmap template and list the 3 main sections.

Checking focus:

Current focus: Write Q1 roadmap document
Time elapsed: 23 minutes (of estimated 45)

Next: Complete the timeline section.

Related Skills

Looking for an alternative to focus or building a Categories.community AI Agent? Explore these related open-source MCP Servers.

View All

widget-generator

Logo of f
f

widget-generator is an open-source AI agent skill for creating widget plugins that are injected into prompt feeds on prompts.chat. It supports two rendering modes: standard prompt widgets using default PromptCard styling and custom render widgets built as full React components.

149.6k
0
Design

chat-sdk

Logo of lobehub
lobehub

chat-sdk is a unified TypeScript SDK for building chat bots across multiple platforms, providing a single interface for deploying bot logic.

73.0k
0
Communication

zustand

Logo of lobehub
lobehub

The ultimate space for work and life — to find, build, and collaborate with agent teammates that grow with you. We are taking agent harness to the next level — enabling multi-agent collaboration, effortless agent team design, and introducing agents as the unit of work interaction.

72.8k
0
Communication

data-fetching

Logo of lobehub
lobehub

The ultimate space for work and life — to find, build, and collaborate with agent teammates that grow with you. We are taking agent harness to the next level — enabling multi-agent collaboration, effortless agent team design, and introducing agents as the unit of work interaction.

72.8k
0
Communication