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

0•

Productivity & Workflow

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

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

01Mistake logging for error prevention and escalation logic

02Acceptance checks to ensure documentation stays synchronized with session results

03Dynamic cross-linking between session entries and technical guides

04Automated session summarization in human-readable markdown

05Persistent storage of project-specific nuances and workflows

060 GitHub stars

Use Cases

01Tracking recurring mistakes to trigger automated promotion or demotion of coding patterns

02Automatically updating internal team guides for PRs, worktrees, and port management after a task

03Recording project-specific troubleshooting steps to avoid repeating research in future sessions

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add mshuffett/dotfiles session-learnings

For use in Claude.ai and ChatGPT

Download Skill