session-reflection

Analyze session history to generate project-specific system prompts and working state.

1|Updated Jul 1, 2026
One-click install
npx skills add https://github.com/jwilger/agent-skills --skill session-reflection-jwilger
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: session-reflection
Source: https://github.com/jwilger/agent-skills/tree/main/skills/session-reflection
Command: npx skills add https://github.com/jwilger/agent-skills --skill session-reflection-jwilger

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Session reflections identify recurring gaps between user expectations and agent behavior, helping teams turn corrections into durable improvements and crash-resilient workflows.

Core Features & Use Cases

  • Analyze session history (conversations, git logs, memory files) to categorize interventions into a structured taxonomy.
  • Generate or refine a project-specific system prompt and a persistent WORKING_STATE.md to prevent context drift and ensure crash recovery.
  • Integrate with a launcher pattern and references to maintain governance across long-running sessions.

Quick Start

Activate after milestones, repeated corrections, or restarts by asking it to analyze the latest session and produce a refreshed system prompt and updated working state.

Frequently Asked Questions about session-reflection

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

FAQPage Schema
How do I prevent context drift and recover my working state after an agent session crash?

Analyzing session history identifies recurring prompt gaps and workflow blockers, such as repeated corrections or restarts. This reflection process categorizes interventions to help teams turn recurring issues into durable system prompt improvements and crash-resilient workflows.

When should I analyze session history to refine project-specific system prompts?

You should analyze session history and refine system prompts after hitting milestones, experiencing repeated corrections, or following restarts. These events indicate workflow blockers or context drift, signaling the need to update the persistent working state and prompt guidelines.

How do I generate a persistent working state from conversation logs and memory files?

To generate a persistent working state, analyze session history including conversations and memory files to categorize interventions. This produces a WORKING_STATE.md file that captures the current progress and integrates with a launcher pattern to maintain governance across long-running sessions.

Can I use a memory protocol to categorize interventions and improve agent behavior?

Yes, applying a memory protocol categorizes session interventions into a structured taxonomy. This categorization identifies recurring gaps between user expectations and agent behavior, generating pattern-based improvements to system prompts for better long-running session resilience.

What are the limitations of relying on session reflections for crash recovery?

Session reflections depend on the availability and completeness of session history data like conversations and git logs. If memory files lack sufficient detail or interventions are not properly categorized, the generated working state and system prompts may fail to prevent context drift effectively.