worklog

Move task entries between worklog.todo.md, worklog.doing.md, and worklog.done.md files.

14|Updated Feb 15, 2026
One-click install
npx skills add https://github.com/tae0y/python-project-template --skill worklog-tae0y
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: worklog
Source: https://github.com/tae0y/python-project-template/tree/main/.claude/skills/worklog
Command: npx skills add https://github.com/tae0y/python-project-template --skill worklog-tae0y

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Update task state in worklog files. Requires explicit arguments.

Core Features & Use Cases

  • Move tasks between backlog (todo) and in-progress (doing) and completed (done) states by updating local files such as worklog.todo.md, worklog.doing.md, and worklog.done.md.
  • Read and modify the appropriate files to reflect progress and completed work.
  • Use case: during a sprint, add a task to the backlog, start it with doing, and mark it done when finished.

Quick Start

Run worklog with a state and description to update your current session's task progress.

Frequently Asked Questions about worklog

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

FAQPage Schema
How do I track task progress across todo, doing, and done states in local files?

Track task progress by moving entries between worklog.todo.md, worklog.doing.md, and worklog.done.md files. You apply explicit state transitions during development sessions by providing a state argument and a task description to update your local worklog files.

What is the best way to manage a sprint backlog using markdown files?

Manage a sprint backlog by adding tasks to worklog.todo.md, moving active items to worklog.doing.md, and appending completed work under today's date in worklog.done.md. This explicit state transition approach keeps project work organized across local markdown files.

How do I move a task to done and record the completion date in a worklog?

Move a task to done by running the worklog command with the done state and a task description. The process reads the source files and appends the completed task entry under today's date in worklog.done.md to record progress.

Can I update task state automatically without providing explicit arguments?

No, updating task state requires explicit arguments in the form of a state keyword and a description. You must provide the target state and task details to modify the corresponding worklog.todo.md, worklog.doing.md, or worklog.done.md files correctly.

Does task tracking with local markdown files work for ongoing development sessions?

Yes, task tracking with local markdown files is designed for development sessions and project work. It handles tasks as they are created, started, and completed by applying explicit state transitions across the worklog files.

Why are my worklog state transitions not updating the correct markdown files?

State transitions fail when explicit arguments are not provided in the correct format. Ensure you specify the state and description accurately so the process reads the correct source files and appends entries to the right worklog markdown file.