worklog

Process time entries into client, project, and task rollups with billing rules.

Updated Jun 6, 2026

Search Tags:#time tracking #client work #billable hours #timesheet #ledger management

Ready to run

npx skills add https://github.com/TopengDev/pi-setup --skill worklog-topengdev

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: worklog
Source: https://github.com/TopengDev/pi-setup/tree/main/skills/worklog
Command: npx skills add https://github.com/TopengDev/pi-setup --skill worklog-topengdev

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill simplifies tracking billable hours for client work, providing accurate logs, rollups, and timesheet generation to streamline the billing process.

Core Features & Use Cases

Time Tracking: Log time entries for various clients, projects, and tasks.
Billable Hours Management: Apply rounding/billing rules and generate timesheets directly usable for invoicing.
Use Case: Ideal for software development teams to maintain accurate records of billable hours, ensuring seamless handoff to billing systems.

Quick Start

Log time spent on a task with /worklog add <client> <project> <hours> "<task>" [date].

Frequently Asked Questions about worklog

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How do I track billable hours for client work using JSONL files?▼

To track billable hours, you log time entries into JSONL files, which the system then processes into client, project, and task rollups. It applies rounding and billing rules to generate timesheets directly usable for invoicing.

Can I generate timesheets with custom rate calculation and timezone conversion?▼

Yes, timesheet generation includes rate calculation, ledger management, and automatic timezone conversion. It processes your raw time entries and applies specific billing rules to output finalized, rollup-ready timesheets.

Do I need Bash to manage timesheets and process time entries?▼

Yes, Bash is required to run the scripts that manage timesheets and process time entries. The system relies on Bash alongside JSONL file handling and JSON parsing to execute its time tracking and ledger management functions.

What is the best way to apply rounding rules to billable hours for software development teams?▼

The best way to apply rounding rules to billable hours is by logging time entries via the command interface. The system automatically processes these entries, applying the configured rounding and billing rules to generate accurate timesheets.

How do I log time spent on a specific project and client task?▼

You log time spent by using the command format to add entries, specifying the client, project, hours, task description, and optional date. The system then parses this input to manage your billable hour records.

Why does my timesheet show incorrect billable hours after logging time entries?▼

Incorrect billable hours on timesheets often result from misconfigured rounding or billing rules during time entry processing. The system applies these specific rules along with timezone conversion, so verifying your input data and configuration ensures accurate rollups.