skillZs
★ LIVE SKILL TAGS ★
>>> LIVE SKILLS INDEX <<<
* OPEN SOURCE *
NO LOGIN, NO TRACKING
※ REAL INSTALL DATA ※
← back to all skills
steveclarke/dotfiles118 installs

time-tracking

Manage time tracking with Toggl or Clockify — timers, timesheets, logging hours, viewing entries, manual entries. Triggers on 'toggl', 'clockify', 'time tracking', 'timer', 'log time'.

How do I install this agent skill?

npx skills add https://github.com/steveclarke/dotfiles --skill time-tracking
view source ↗

Is this agent skill safe to install?

  • Gen Agent Trust Hubpass

    The skill manages time tracking via Toggl and Clockify. It caches API tokens locally in plaintext and has a surface for indirect prompt injection from external API data.

  • Socketpass

    No alerts

  • Snykpass

    Risk: LOW · No issues

  • Runlayerwarn

    2/2 files flagged

What does this agent skill do?

Time Tracking

Use scripts/track for all time tracking operations. Supports both Toggl (default) and Clockify.

Commands

# Real-time tracking (default: Toggl)
scripts/track start "Task description" -p "Project Name"
scripts/track stop
scripts/track current

# Use Clockify instead
scripts/track start "Task description" -p "Project Name" -P clockify
scripts/track current -P clockify

# Manual entries (past dates)
scripts/track create "Description" -p "Project" -s "YYYY-MM-DD HH:MM" -e "YYYY-MM-DD HH:MM"
scripts/track create "Description" -p "Project" -s "..." -e "..." -t "tag1,tag2"  # with tags

# Management
scripts/track delete <entry-id>
scripts/track entries --days 7
scripts/track projects
scripts/track me

# Projects and tags (Toggl only)
scripts/track project:create "Project Name"
scripts/track project:create "Project Name" -b        # billable
scripts/track project:create "Project Name" --private # private project
scripts/track tags

Provider Selection

  • -P toggl (default) - Use Toggl Track
  • -P clockify - Use Clockify

Notes

  • Project names must match exactly - use projects to list available names
  • Authentication via 1Password:
    • Toggl: op://Employee/Toggl/api key
    • Clockify: op://Employee/Clockify/Saved on app.clockify.me/apikey
  • Token caching: API tokens are cached in ~/.local/state/steveos/time-tracking/ for 24 hours to avoid repeated 1Password prompts
  • Run scripts/track --help for full usage

Cache Management

scripts/track cache:clear      # Clear token for current provider
scripts/track cache:clear:all  # Clear all cached tokens

Use these if you rotate your API key in 1Password or need to re-authenticate.

Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.

<a href="https://skillzs.dev/skills/steveclarke/dotfiles/time-tracking">View time-tracking on skillZs</a>