Skip to content
LiveNew tools this week
Submit
AIMarketly
CS2 Demo Analyzer Skill logo

CS2 Demo Analyzer Skill

Analyze CS2 demo files and generate comprehensive tactical reports

majiayu000/claude-skill-registry0installs663stars

SKILL.md

Full skill instructions

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)