Timesheet Clawdbot Skill

A Clawdbot skill for controlling timesheet.io time tracking via the CLI.

Prerequisites

Install the timesheet CLI:

npm install -g @timesheet/cli

Authenticate:

timesheet auth login

Or set an API key for automation:

export TIMESHEET_API_KEY=ts_your.apikey

Installation

Option 1: Workspace Skills (Recommended)

Copy to your workspace's skills directory:

cp -r timesheet <your-workspace>/skills/

Option 2: User Skills

Copy to your Clawdbot user directory:

cp -r timesheet ~/.clawdbot/skills/

Option 3: Extra Directories

Add this directory to your ~/.clawdbot/clawdbot.json:

{
  "skills": {
    "load": {
      "extraDirs": ["/path/to/clawdbot-skill"]
    }
  }
}

Usage

As Slash Command

/timesheet

Natural Language

The skill is automatically available to the model. Just ask:

• "Start a timer for project X"
• "What's my timer status?"
• "Stop my timer"
• "Show my tasks for today"
• "How much time did I log this week?"
• "Create a new project called Client Work"

Capabilities

Category	Commands
Timer	start, stop, pause, resume, status, update
Projects	list, create, show, update, delete
Tasks	list, create, show, update, delete
Teams	list
Tags	list, create, delete
Reports	summary, export
Profile	show, settings
Config	show, set, reset

Configuration

Disable or configure the skill in ~/.clawdbot/clawdbot.json:

{
  "skills": {
    "entries": {
      "timesheet": {
        "enabled": true,
        "env": {
          "TIMESHEET_API_KEY": "ts_your.apikey"
        }
      }
    }
  }
}

Skill Structure

timesheet/
└── SKILL.md    # Skill definition with YAML frontmatter and instructions

Links

• timesheet.io - Time tracking platform
• @timesheet/cli on npm - CLI package
• Clawdbot Skills Documentation - Skills reference

License

MIT