---
description: Analyze CS2 demo files and generate comprehensive tactical reports
---

# 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)