session-improve

Analyze Claude Code session logs to identify and implement workflow improvements.

Updated May 7, 2026
One-click install
npx skills add https://github.com/tmalcolm-0607/mad-council-claw --skill session-improve
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: session-improve
Source: https://github.com/tmalcolm-0607/mad-council-claw/tree/main/.claude/skills/session-improve
Command: npx skills add https://github.com/tmalcolm-0607/mad-council-claw --skill session-improve

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill eliminates the recurring workflow friction, session errors, and undocumented failure patterns that slow down AI-assisted development and create inconsistent experiences across Claude Code sessions.

Core Features & Use Cases

  • Session Log Review: Analyze Claude Code session transcripts to identify recurring user frustrations, common errors, and workflow bottlenecks.
  • Failure Pattern Analysis: Cross-reference failure data across features to find gaps in CLAUDE.md, skills, and agent configurations.
  • Approved Improvement Application: Implement user-vetted changes to documentation, skills, and agents with built-in safety guardrails like backups and validation. Use Case: A development team can run the review subcommand to identify frequent hook failures, analyze the patterns to prioritize fixes, and apply approved changes to reduce recurring errors across all sessions.

Quick Start

Invoke the session-improve skill with the review subcommand to analyze your recent Claude Code session logs for recurring friction and improvement opportunities.

Frequently Asked Questions about session-improve

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

FAQPage Schema
How do I fix recurring errors and friction in Claude Code sessions?

To fix recurring Claude Code session errors, scan session logs and feature context files to identify failure patterns, then apply approved changes to documentation and agent configurations with safety guardrails and backups.

What's the best way to analyze Claude Code session logs for workflow optimization?

Analyze Claude Code session logs to identify recurring friction by cross-referencing failure data across features, finding gaps in CLAUDE.md rules, skills, and agent configurations that cause inconsistent experiences.

How do I find documentation gaps causing AI-assisted development failures?

Find documentation gaps causing AI-assisted development failures by scanning session transcripts and ecosystem documentation to locate undocumented failure patterns, then implementing validated changes to close those gaps.

Can I automatically apply changes to CLAUDE.md rules and skills from session analysis?

Yes, you can automatically apply user-vetted changes to CLAUDE.md rules, skills, and agents from session analysis, using built-in safety guardrails like backups and validation to ensure safe implementation.

Does session analysis work for standardizing development workflows across multiple features?

Session analysis works for standardizing development workflows across multiple features by cross-referencing failure data to prioritize high-impact improvements and applying approved changes to reduce recurring errors across all sessions.

Why do I keep seeing the same hook failures in my Claude Code development environment?

Recurring hook failures in your Claude Code environment happen when gaps in CLAUDE.md rules, skills, or agent configurations go undocumented; scanning session logs identifies these patterns for targeted fixes.