Good AI Tools

>> productivity-skills-plugin/skills/conversation-analyzer

stars: 116
forks: 12
watches: 116
last updated: 2025-12-09 14:26:05

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

  1. Request type distribution (bug fixes, features, refactoring, queries, testing)
  2. Most active projects
  3. Common error keywords
  4. Time-of-day patterns
  5. Repetitive tasks (automation opportunities)
  6. Vague requests causing back-and-forth
  7. Complex tasks attempted without planning
  8. 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.