CS2 Demo Analyzer Skill

This skill analyzes Counter-Strike 2 demo files (.dem) and produces professional tactical analysis reports with strategic insights, player statistics, and coaching recommendations.

What This Skill Does

1. •Accepts a CS2 demo file (drag & drop or provide path)
2. •Generates multi-format analysis:
   • •Compact storage format for archival
   • •Digest summary for quick review
   • •Full markdown tactical report
3. •Returns strategic insights including:
   • •Team performance (T-side vs CT-side)
   • •Player statistics and rankings
   • •Critical round breakdowns
   • •Tactical recommendations
   • •Entry success, post-plant win rates, tempo analysis

For End Users

Simple Usage

Just say:

• •"Analyze this demo" (after dragging .dem file)
• •"Analyze data/raw/my-game.dem"
• •"Give me a tactical report for the latest demo"

What You'll Get

A comprehensive report covering:

• •Executive Summary - Top 3-5 strategic insights
• •Team Analysis - T-side and CT-side performance
• •Critical Rounds - Key moments that decided the game
• •Player Highlights - Top performers and improvement areas
• •Tactical Recommendations - Actionable coaching points

Requirements (One-Time Setup)

This skill requires:

• •✅ Python 3.11+ with Poetry installed
• •✅ Project dependencies installed (poetry install)
• •✅ Directory structure: data/raw/, data/compact/, data/digest/, reports/

Setup Instructions: See docs/setup.md for first-time installation.

How It Works

The skill uses a three-tier architecture:

1. •Parse Demo → Extract game data using awpy library
2. •Generate Formats:
   • •Compact state (storage, ~400KB)
   • •Digest (Claude-readable, <50KB)
   • •Full report (markdown)
3. •Strategic Analysis → Metrics calculation and tactical insights

Example Output

# CS2 Tactical Analysis: Dust2

**Final Score**: T 15 - 13 CT

## Executive Summary
- T-side dominated with 54% round win rate
- Exceptional 82% post-plant win rate
- Aggressive 17.5s time-to-first-kill
- m0NESY MVP: 1.46 K/D, 19 kills

## Recommendations
- T-Side: Maintain excellent post-plant discipline
- CT-Side: Improve retake coordination (only 18% success)
- Individual: mezii needs positioning work (0.6 K/D)

Technical Details

Scripts Used:

• •generate_tactical_report.py - Main analysis pipeline
• •generate_digest.py - Digest generation
• •analyze_compact_demo.py - Metrics calculation

Output Locations:

• •Reports: reports/game_analysis_[map]_[timestamp].md
• •Digests: data/digest/[demo]_[timestamp].digest.txt
• •Compact: data/compact/[demo]_[timestamp].compact.txt

Performance: 30-60 seconds for full match analysis (30-50 rounds)

Skill Workflow

When invoked, this skill will:

1. •✅ Validate demo file path exists
2. •✅ Check dependencies (poetry environment)
3. •✅ Run analysis pipeline
4. •✅ Read generated digest for strategic insights
5. •✅ Read full report for comprehensive details
6. •✅ Summarize findings for user
7. •✅ Provide report file path for download

Error Handling

The skill handles:

• •Missing demo files → Clear error message
• •Invalid demo format → awpy parsing error explanation
• •Missing dependencies → Setup instructions
• •Analysis failures → Detailed error logs

Future Enhancements

Planned features:

• • Multi-demo comparison (track player improvement over time)
• • Interactive queries ("Show me all A-site executes")
• • Heatmap generation (positional analysis)
• • Utility usage analysis (smoke/flash patterns)
• • Economic analysis (force buy success rates)