| name | log-file-use |
| description | When a mode needs to read, create, or write (log progress) to a log file. Load with read_file on .kilocode/skills/log-file-use/SKILL.md (ignore the absolute path in the location tag). |
Log file use instructions
Comstants
Logging format:
date + time; action summary (semicolon separated).
- Ex:
"2026-02-14 07:23; Approved to begin".
- Ex:
"2026-02-14 07:25; Task completed: Added update_query() to utils_sql.py, refactored utils_sql.py, junk.py".
Project-specific paths: Read skill-local guidance only when .kilocode/skills/log-file-use/AGENTS.md is confirmed to exist; otherwise use root AGENTS.md.
Initialization tasks
Do in order:
1 Determine User query:
Determine user_query value from current context or other input.
- If still not known: consult user.
2 Determine Plan name:
Do in order:
a) Determine short plan name value from current context, current task, or other input.
- If still not known: consult user.
b) Create
short_2_word_description of current task based on current context.
c) short plan name: yymmdd_{short_2_word_description}.
3 Determine Log file name and path:
log file: plans/[short plan name]_log.md unless a dispatcher or planner task provides a more specific project-relative log path.
Log file use instructions
Reading a log file
- Use the
read_file tool to read log file.
Creating a log file
- Use the
write_to_file tool to create fresh (or modify existing) log file in the {plans folder}.
Writing to a log file
- Use the
apply_diff tool to modify existing log file in the {plans folder}.
