session-log

Generate timestamped hourly session log entries for modified repository files.

Updated Feb 26, 2026
One-click install
npx skills add https://github.com/naj2r/claude-econ-paper-template --skill session-log-naj2r
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: session-log
Source: https://github.com/naj2r/claude-econ-paper-template/tree/main/.claude/skills/session-log
Command: npx skills add https://github.com/naj2r/claude-econ-paper-template --skill session-log-naj2r

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill automates creation of timestamped, hourly session logs and prevents noisy entries by only recording windows where repository files have actually changed, making activity tracking and reproducibility easier for research and writing sessions.

Core Features & Use Cases

  • Detects file modifications since a stored timestamp marker and skips logging when no changes occurred to preserve signal and avoid clutter.
  • Appends formatted hourly entries to a daily markdown session log and updates a last-log timestamp marker; can launch a session-logger agent to produce human-readable summaries.
  • Produces end-of-session summaries suitable for insertion into a replication book chapter, including files modified, aggregated decisions, and next steps.

Quick Start

Invoke /session-log init to start a session timer, call /session-log check periodically to log changes, and run /session-log close to produce the final session summary.

Frequently Asked Questions about session-log

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

FAQPage Schema
How do I automate hourly session logging for research files without generating empty log entries?

Idle-aware hourly session logging detects file modifications since a stored timestamp marker and skips appending entries to daily markdown logs when no repository files have changed, preserving signal and avoiding clutter.

How do I track file modifications across a Claude Code replication book during active writing sessions?

Session logging scans specified replication book files and .claude components, reads and compares file timestamps, and appends formatted hourly entries to a daily markdown log to track modifications during research or writing sessions.

What is the best way to generate end-of-session summaries for a replication book chapter from markdown logs?

Running a session close command produces end-of-session summaries suitable for insertion into a replication book chapter, aggregating modified files, decisions, and next steps from the daily markdown session log.

Do I need a session-logger agent to produce human-readable summaries from timestamped log entries?

A session-logger agent is optional; the logging workflow can invoke the agent to produce human-readable summaries from hourly log entries, or append formatted entries directly to the daily markdown log.

How do I start and maintain a timestamp marker for idle-aware file change detection in a research project?

Initialize a session timer to start tracking, call a periodic check command to compare file timestamps against a last-log marker, and update the marker each time new modifications are appended to the log.

Can I use this session logging workflow if my project has no external dependencies?

Yes, the session logging workflow operates with no external dependencies, relying solely on reading file timestamps and appending entries to markdown files within your active project directory.