session-log

Write durable session logs capturing completed work, findings, and next steps.

Updated Sep 11, 2026
One-click install
npx skills add https://github.com/cameronbracken/waterology-research --skill session-log-cameronbracken
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: session-log
Source: https://github.com/cameronbracken/waterology-research/tree/main/skills/session-log
Command: npx skills add https://github.com/cameronbracken/waterology-research --skill session-log-cameronbracken

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Research sessions produce decisions, findings, and open questions that are easily lost when context is discarded. This Skill preserves that work as a durable Markdown log so progress can be resumed and audited later. ## Core Features & Use Cases - Session Documentation: Captures completed work, strongest findings, decisions, open questions, unresolved risks, and concrete next steps. - Checkpoint Handoff: Preserves branch/worktree state, run and session identities, failed approaches, blockers, and ordered restart steps before context is discarded. - Artifact Linking: References verified artifacts under notes/, docs/, experiments/, or papers/ and includes direct URLs for external claims. - Use Case: After a long analysis session, ask for a session log and get a dated entry at notes/<date>-session.md summarizing what was done and what comes next. ## Quick Start Ask the assistant to log today's session progress and save it as a dated session note in the notes directory.

Frequently Asked Questions about session-log

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

FAQPage Schema
How do I save a research session log?▼

Ask the assistant to log progress or write up what was done. The Skill writes a Markdown entry to notes/<date>-session.md covering completed work, findings, open questions, risks, and next steps.

What should a session log include for research work?▼

A session log should capture completed work, the strongest findings and decisions, open questions, unresolved risks, and concrete next steps. It should link artifacts under notes/, docs/, experiments/, or papers/ rather than copying full logs.

Where are session log files saved?▼

Logs are saved to notes/<date>-session.md using the current date, with an optional short topic suffix to distinguish multiple logs from the same day.

Can a session log preserve state before context is lost?▼

Yes. At substantial checkpoints the log records branch/worktree, active run and session identities, frozen decisions, failed approaches, blockers, and ordered restart steps so work can resume after context is discarded.

What is the difference between a session log and project lessons?▼

The narrative session log records what happened, while the project-learning skill extracts reusable lessons with evidence from the handoff. They serve different purposes and neither replaces the other.