mcpbeat

Conversation Analyzer

mhattingpete/conversation-analyzer

Analyzes your Claude Code conversation history to identify patterns, common mistakes, and opportunities for workflow improvement. Use when user wants to understand usage patterns, optimize workflow, identify automation opportunities, or check if they're following best practices.

5k tokens
context cost
the whole folder, loaded on every use
2
files
ships runnable scripts
0
copies elsewhere
how many repositories repackaged it
656
stars on the repo
on the repository, not the skill itself

Install

one command, takes just this skill from the repository
npx skills add https://github.com/mhattingpete/claude-skills-marketplace --skill conversation-analyzer

The instruction itself

18 sections, as written by the author

Conversation Analyzer

Analyzes your Claude Code conversation history to identify patterns, common mistakes, and workflow improvement opportunities.

When to Use

  • "analyze my conversations"
  • "review my Claude Code history"
  • "what patterns do you see in my usage"
  • "how can I improve my workflow"
  • "am I using Claude Code effectively"

What It Analyzes

  • Request type distribution (bug fixes, features, refactoring, queries, testing)
  • Most active projects
  • Common error keywords
  • Time-of-day patterns
  • Repetitive tasks (automation opportunities)
  • Vague requests causing back-and-forth
  • Complex tasks attempted without planning
  • Recurring bugs/errors

Analysis Scope

Default: Last 200 conversations for recency and relevance.

Methodology

1. Request Type Distribution

Categorizes by: bug fixes, feature additions, refactoring, information queries, testing, other.

2. Project Activity

Tracks which projects consume most time, identifies project-specific patterns.

3. Time Patterns

Hour-of-day usage distribution, identifies peak productivity times.

4. Common Mistakes

  • Vague requests: Initial requests lacking context vs. acceptable follow-ups
  • Repeated fixes: Same issues occurring multiple times
  • Complex tasks: Multi-step requests without planning
  • Repetitive commands: Manual tasks that could be automated

5. Error Analysis

Frequency of error-related requests, common error keywords, recurring problems.

6. Automation Opportunities

Identifies repeated exact requests, suggests skills, slash commands, or scripts.

Output

Structured report with:

  • Statistics: Request types, active projects, timing patterns
  • Patterns: Common tasks, repetitive commands, complexity indicators
  • Issues: Specific problems with examples
  • Recommendations: Prioritized, actionable improvements

Tools Used

  • Read: Load history file (~/.claude/history.jsonl)
  • Write: Create analysis reports if requested
  • Bash: Execute Python analysis script
  • Direct analysis: Parse JSON programmatically

Analysis Script

Uses scripts/analyze_history.py for comprehensive analysis:

Capabilities:

  • Loads and parses ~/.claude/history.jsonl
  • Analyzes patterns across multiple dimensions
  • Identifies common mistakes and inefficiencies
  • Generates actionable recommendations
  • Outputs detailed reports

Usage within skill:

Runs automatically when user requests analysis.

Standalone usage:

cd ~/.claude/plugins/*/productivity-skills/conversation-analyzer/scripts
python3 analyze_history.py

Outputs:

  • conversation_analysis.txt - Detailed pattern analysis
  • recommendations.txt - Specific improvement suggestions

Example Output

Analyzed last 200 conversations:
- 60% general tasks, 15% bug fixes, 13% feature additions
- Project "ultramerge" dominates 58% of activity
- Same test-fixing request made 8 times
- 19 multi-step requests without planning
- Peak productivity: 13:00-15:00

Recommendations:
- Use test-fixing skill for recurring test failures
- Create project-specific utilities for ultramerge
- Use feature-planning skill for complex requests
- Add tests to prevent recurring bugs
- Schedule complex work during peak hours

Success Criteria

  • User understands usage patterns
  • Concrete, actionable recommendations
  • Specific examples from history
  • Prioritized by impact (quick wins vs long-term)
  • User can immediately apply improvements

Integration

  • feature-planning: Implement recommended improvements
  • test-fixing: Address recurring test failures
  • git-pushing: Commit workflow improvements

Privacy Note

All analysis happens locally. Conversation history never leaves user's machine.

How to use it

Copy the folder

Take mhattingpete/conversation-analyzer from the repository into ~/.claude/skills for personal use, or into .claude/skills inside a project.

Check the name does not clash

The agent identifies a skill by the name field in its header. Two skills with the same name cannot sit side by side — one of them will be ignored.