How does this skill help with documentation?

The skill includes logic to cross-link session entries to relevant guides and requires an acceptance check to ensure those guides are updated as workflows change.

What is the primary purpose of the Session Learnings skill?

It serves as a persistence layer for Claude, allowing it to document what was learned, what went wrong, and what documentation needs updating after a coding session.

Where are the session logs and mistake files stored?

Summaries are stored in ~/.claude/logs/session-learnings.md, while technical event logs are kept in ~/.claude/mistakes.jsonl.

Does it support automated escalation logic?

Yes, it uses a structured mistakes.jsonl file designed for automated promotion or demotion decisions based on the frequency and type of errors encountered.

Can humans read the session logs?

Absolutely. While the mistakes log is structured for logic, the session-learnings.md file is designed specifically for human readability and review.

Session Learnings Tracker

Name: Session Learnings Tracker
Author: mshuffett

bymshuffett

Productivity & Workflow

Captures and documents key takeaways from coding sessions to improve future AI performance and maintain project-specific knowledge.

About

The Session Learnings skill provides a structured way for Claude to maintain persistent memory and contextual awareness across multiple coding sessions. By appending human-readable summaries to a central log and tracking mistakes in a machine-readable format, this skill ensures that insights, roadblocks, and updated workflows are never lost. It enables Claude to learn from past errors and proactively update project guides, resulting in a more efficient and personalized development experience that evolves alongside your codebase.

Key Features

Mistake logging for error prevention and escalation logic
Acceptance checks to ensure documentation stays synchronized with session results
Dynamic cross-linking between session entries and technical guides
Automated session summarization in human-readable markdown
Persistent storage of project-specific nuances and workflows
0 GitHub stars

Use Cases

Tracking recurring mistakes to trigger automated promotion or demotion of coding patterns
Automatically updating internal team guides for PRs, worktrees, and port management after a task
Recording project-specific troubleshooting steps to avoid repeating research in future sessions

About

Key Features

Mistake logging for error prevention and escalation logic
Acceptance checks to ensure documentation stays synchronized with session results
Dynamic cross-linking between session entries and technical guides
Automated session summarization in human-readable markdown
Persistent storage of project-specific nuances and workflows
0 GitHub stars

Use Cases

Tracking recurring mistakes to trigger automated promotion or demotion of coding patterns
Automatically updating internal team guides for PRs, worktrees, and port management after a task
Recording project-specific troubleshooting steps to avoid repeating research in future sessions