Deepfocus

Run Pomodoro sessions with break timers and productivity tracking. Use when starting focus sessions, tracking streaks, reviewing productivity.

Security Scan

The skill's code, runtime instructions, and requested resources are consistent with a simple local, file-based Pomodoro/productivity tool, though the package provenance is minimal (no homepage) so verify origin if that matters to you.

Purpose & Capability

The name/description describe a local productivity tracker and the provided script implements the listed commands, stores logs, and reports stats. There are no unrelated dependencies or credentials requested.

Instruction Scope

SKILL.md simply instructs running scripts/script.sh <command>. The script operates only on a single data directory (~/.local/share/deepfocus) and its own log files; it does not read arbitrary system files or contact external endpoints.

Install Mechanism

No install spec is declared and the bundle contains a bash script. Nothing is downloaded or extracted at install time, so there is no high-risk install mechanism.

Credentials

The skill requests no environment variables or credentials. It writes/reads only to ~/.local/share/deepfocus, which is proportional for a file-based CLI tracker. Note: it will create and modify files under the user's home directory.

Persistence & Privilege

always is false and the skill does not modify other skills or system-wide agent settings. Its persistence is limited to the data files it writes under the user's home directory.

Assessment

This skill appears to do exactly what it says: a local, file-based productivity logger implemented as a bash script. Before installing or running it, consider: 1) provenance — the registry metadata lists no homepage or repo (the script header references bytesagain.com), so verify the source if you require strong provenance; 2) filesystem changes — the script will create and write logs to ~/.local/share/deepfocus (back up anything important in that path first); 3) sensitive data — do not store passwords or secrets in the logs (entries are stored in plain text and exported without escaping); 4) code review — the script is short and readable; if you are security-conscious, inspect scripts/script.sh locally before running. If you are comfortable with these tradeoffs, the skill is coherent and low-risk for normal personal use.

Deepfocus v2.0.0 — a productivity toolkit for managing tasks, plans, reviews, streaks, reminders, and more from the command line.

Commands

Run via: bash scripts/script.sh <command> [args]

Command	Description
add <input>	Add a new entry (task, note, idea). Without args, shows recent entries.
plan <input>	Create or view plan entries for organizing your day/week.
track <input>	Track progress on goals, habits, or tasks.
review <input>	Log review notes — reflect on what went well or needs improvement.
streak <input>	Record streak data for habit tracking and consistency.
remind <input>	Set reminders and notes for future reference.
prioritize <input>	Mark and log priority levels for tasks.
archive <input>	Archive completed or outdated entries.
tag <input>	Tag entries with labels for easy categorization.
timeline <input>	Add timeline entries for chronological tracking.
report <input>	Generate or log report entries for summaries.
weekly-review <input>	Log weekly review notes for end-of-week reflection.
stats	Show summary statistics across all entry types.
export <fmt>	Export all data in json, csv, or txt format.
search <term>	Search across all log files for a keyword.
recent	Show the 20 most recent activity entries from the history log.
status	Health check — version, data directory, entry count, disk usage.
help	Show the built-in help message with all available commands.
version	Print the current version (deepfocus v2.0.0).

Each data command (add, plan, track, etc.) works in two modes:

• With arguments: saves the input with a timestamp to its dedicated log file.
• Without arguments: displays the 20 most recent entries from that log.

Data Storage

All data is stored locally in ~/.local/share/deepfocus/:

• Each command has its own log file (e.g., add.log, plan.log, track.log)
• Entries are saved in timestamp|value format
• A unified history.log records all activity across commands
• Export files are written to the same directory

Requirements

• Bash (standard system shell)
• No external dependencies — uses only coreutils (date, wc, du, grep, tail, cat)

When to Use

• When you need to quickly add tasks, plans, or notes from the terminal
• To track daily habits and maintain productivity streaks
• For end-of-day or weekly reviews and reflections
• To set reminders and prioritize tasks without leaving the command line
• To search through past entries by keyword
• To export your productivity data for analysis or backup
• When you want a lightweight, file-based focus and task management system

Examples

# Add a task
deepfocus add "Write unit tests for the auth module"

# Create a plan for the day
deepfocus plan "Morning: deep work on API refactor. Afternoon: PR reviews."

# Track a habit
deepfocus track "Completed 45-minute focus session on documentation"

# Log a review
deepfocus review "Good progress on backend. Need to speed up frontend work."

# Record a streak
deepfocus streak "Day 15 of daily coding — still going strong"

# Set a reminder
deepfocus remind "Submit expense report by end of week"

# Prioritize a task
deepfocus prioritize "P0: Fix production memory leak"

# Archive an old entry
deepfocus archive "Q3 planning notes — no longer relevant"

# Tag an entry
deepfocus tag "meeting-notes: Sprint retrospective takeaways"

# Add to timeline
deepfocus timeline "Shipped v2.0 release to production"

# Generate a report
deepfocus report "Weekly output: 12 tasks completed, 3 carried over"

# Log a weekly review
deepfocus weekly-review "Best week this month — cleared the entire backlog"

# View all statistics
deepfocus stats

# Export everything as JSON
deepfocus export json

# Search for entries mentioning "focus"
deepfocus search focus

# Check recent activity
deepfocus recent

# Health check
deepfocus status

---

Powered by BytesAgain | bytesagain.com | [e-mail]