
Detecting Ransomware Encryption Behavior
FreeReal-time detection of ransomware encryption activity.
Free · Opens the source repo
What Detecting Ransomware Encryption Behavior does
The Detecting Ransomware Encryption Behavior skill provides a robust framework for identifying ransomware activity in real time through a combination of entropy analysis, file system monitoring, and behavioral scoring. By leveraging tools such as Sysmon and libraries like watchdog and psutil, this skill allows users to monitor file modifications and detect abnormal patterns indicative of encryption routines. It is particularly useful for security professionals looking to enhance their defenses against unknown or zero-day ransomware variants.
This skill operates by establishing baseline entropy values for various file types, enabling the detection of high-entropy content that typically signifies encryption. For example, text-based files exhibit significant entropy increases when encrypted, making them prime candidates for detection. The skill also tracks file system I/O patterns, identifying behaviors such as rapid file modifications, extension changes, and the creation of ransom notes, which are common indicators of ransomware activity.
The implementation requires a solid understanding of entropy and access to necessary monitoring tools. Users can configure automated responses based on the behavioral scoring generated by the skill, allowing for immediate action when ransomware is detected. This makes it an essential tool for incident response teams and organizations aiming to protect their endpoints from ransomware attacks.
Overall, this skill is designed for developers and security analysts who require a comprehensive solution for real-time ransomware detection, combining multiple signals to minimize false positives and enhance detection accuracy.
When to use it
Use this skill when building a behavioral detection layer for ransomware or monitoring endpoints for suspicious file modification activities.
When not to use it
Do not rely solely on this skill for ransomware detection; it should be part of a broader security strategy that includes additional detection methods.
What you can build with it
Monitoring File Servers
Use this skill to monitor file servers for mass encryption activity that could indicate a ransomware attack.
Red Team Exercises
Validate EDR detection rules against actual ransomware patterns during red team exercises to improve incident response.
Real-Time Ransomware Detection
Implement this skill to provide real-time alerts and automated responses when suspicious file modifications are detected.
How to install Detecting Ransomware Encryption Behavior
View source1. Install with the skills CLI
npx skills add mukul975/anthropic-cybersecurity-skills/detecting-ransomware-encryption-behavior --agent claude-code2. Or install it manually
Download the skill folder and drop it into ~/.claude/skills/ for all projects, or .claude/skills/ to scope it to one repo. Restart Claude Code so it picks up the new skill.
Anthropic's agentic coding CLI, and the reference implementation of Agent Skills. Drop a skill folder into ~/.claude/skills and Claude Code loads it automatically whenever a task matches the skill's description. Claude Code docs
Inside SKILL.md
Written by mukul975Detecting Ransomware Encryption Behavior
When to Use
- Building or tuning a behavioral detection layer for ransomware that catches unknown/zero-day variants
- Monitoring file servers and endpoints for mass encryption activity that evades signature-based detection
- Implementing entropy-based detection to identify when files are being replaced with encrypted (high-entropy) content
- Analyzing suspicious process behavior patterns: rapid sequential file opens, writes, renames, and deletes
- Validating EDR detection rules against actual ransomware encryption patterns during red team exercises
Do not use entropy analysis alone as the only detection signal. Compressed files (ZIP, JPEG, MP4) naturally have high entropy and will cause false positives. Always combine entropy with behavioral signals like I/O rate and file rename patterns.
Prerequisites
- Python 3.8+ with
watchdogandpsutillibraries - Administrative access for process monitoring and file system event capture
- Understanding of Shannon entropy and its application to file content analysis
- Windows: Sysmon installed for detailed process and file system event logging
- Linux: auditd configured for file access monitoring, or inotify-based watchers
- Baseline entropy values for common file types in the monitored environment
Workflow
Step 1: Establish Entropy Baselines
Calculate normal entropy ranges for files in the environment:
Entropy Baselines by File Type:
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
File Type Normal Entropy Encrypted Entropy
.docx 3.5 - 6.5 7.8 - 8.0
.xlsx 4.0 - 6.8 7.8 - 8.0
.pdf 5.0 - 7.2 7.8 - 8.0
.txt 2.0 - 5.0 7.8 - 8.0
.csv 2.0 - 5.5 7.8 - 8.0
.sql 2.5 - 5.0 7.8 - 8.0
.jpg/.png 7.0 - 7.9 7.9 - 8.0 (hard to distinguish)
.zip/.7z 7.5 - 8.0 7.9 - 8.0 (hard to distinguish)
Key insight: Text-based files show the largest entropy jump when encrypted,
making them the best candidates for entropy-based detection.
Step 2: Implement Real-Time Entropy Monitoring
Monitor file writes and calculate entropy of new content:
import math
from collections import Counter
def shannon_entropy(data):
"""Calculate Shannon entropy of byte data (0.0 to 8.0 scale)."""
if not data:
return 0.0
freq = Counter(data)
length = len(data)
return -sum((c / length) * math.log2(c / length) for c in freq.values())
def is_encryption_entropy(data, threshold=7.5):
"""Check if data entropy indicates encryption."""
entropy = shannon_entropy(data)
return entropy >= threshold, entropy
Step 3: Monitor File System I/O Patterns
Track process-level file operations for ransomware patterns:
Ransomware I/O Behavior Signatures:
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
1. Rapid sequential file modification:
- >20 files modified per minute by single process
- Read original → Write encrypted → Rename with new extension
- Pattern: CreateFile → ReadFile → WriteFile → CloseHandle → MoveFile
2. File extension changes:
- Original: report.docx → Encrypted: report.docx.locked
- Many extensions changed within short time window
3. Ransom note creation:
- Same text file (README.txt, DECRYPT.html) created in multiple directories
- Created immediately after file encryption in each directory
4. Shadow copy deletion:
- vssadmin.exe delete shadows /all /quiet
- wmic.exe shadowcopy delete
- PowerShell: Get-WmiObject Win32_Shadowcopy | Remove-WmiObject
5. Entropy spike pattern:
- File read: entropy 3.5 (normal document)
- File write: entropy 7.9 (encrypted content)
- Delta > 3.0 is strong ransomware indicator
Step 4: Implement Behavioral Scoring
Combine multiple signals into a composite ransomware score:
def calculate_ransomware_score(process_metrics):
"""Score process behavior for ransomware likelihood (0-100)."""
score = 0
# High file modification rate
files_per_min = process_metrics.get("files_modified_per_minute", 0)
if files_per_min > 50:
score += 30
elif files_per_min > 20:
score += 15
# Entropy increase in written files
avg_entropy_delta = process_metrics.get("avg_entropy_delta", 0)
if avg_entropy_delta > 3.0:
score += 30
elif avg_entropy_delta > 2.0:
score += 15
# File extension changes
extension_changes = process_metrics.get("extension_changes", 0)
if extension_changes > 10:
score += 20
elif extension_changes > 3:
score += 10
# Ransom note creation
if process_metrics.get("ransom_note_created", False):
score += 20
return min(score, 100)
Step 5: Configure Automated Response Thresholds
Set detection thresholds and automated containment actions:
Detection Thresholds:
━━━━━━━━━━━━━━━━━━━━
Score 0-25: INFORMATIONAL - Log only, no action
Score 25-50: LOW - Alert SOC for investigation
Score 50-75: HIGH - Alert SOC, suspend process, snapshot VM
Score 75-100: CRITICAL - Kill process, isolate endpoint, alert IR team
Automated Response Actions:
- Suspend/kill the encrypting process
- Disable network adapter to prevent lateral movement
- Create volume shadow copy snapshot before further damage
- Capture process memory dump for forensic analysis
- Send SIEM alert with process details, affected files, and timeline
Verification
- Test detection against known ransomware samples in an isolated sandbox environment
- Verify that entropy monitoring correctly identifies encrypted vs. compressed files
- Confirm that behavioral scoring produces low false-positive rates on normal workloads
- Validate automated response actions execute within acceptable time (under 5 seconds)
- Test with multiple ransomware families (LockBit, BlackCat, Conti) to verify coverage
- Benchmark monitoring overhead to ensure it does not degrade endpoint performance
Key Concepts
| Term | Definition |
|---|---|
| Shannon Entropy | Mathematical measure of randomness in data (0-8 for bytes); encrypted data approaches 8.0, while text files are typically 2-5 |
| Differential Entropy | The change in entropy between a file's original and modified content; a spike indicates encryption |
| I/O Rate Anomaly | Abnormally high rate of file read/write operations by a single process, characteristic of bulk encryption |
| Behavioral Scoring | Combining multiple weak signals (entropy, I/O rate, file renames) into a composite confidence score |
| Entropy Evasion | Techniques used by advanced ransomware to defeat entropy detection, such as Base64 encoding output or partial encryption |
Tools & Systems
- Sysmon: Windows system monitor providing detailed file system and process events for behavioral analysis
- watchdog (Python): Cross-platform file system monitoring library for real-time file change detection
- psutil (Python): Process and system monitoring library for tracking per-process I/O statistics
- Elastic Endpoint: Commercial endpoint protection with built-in ransomware behavioral detection using canary files
- Wazuh: Open-source security platform with file integrity monitoring and active response capabilities
Frequently asked questions about Detecting Ransomware Encryption Behavior
Similar skills
Asset Criticality Scoring for Vulns
Prioritize vulnerabilities based on asset criticality.
Performing Alert Triage with Elastic SIEM
Streamline alert triage processes in Elastic Security.
Active Directory Vulnerability Assessment
Secure your Active Directory with comprehensive assessments.
Active Directory Investigation
Streamline your Active Directory compromise investigations.
Parsing Artifacts with Eric Zimmerman Tools
Efficiently parse Windows forensic artifacts for analysis.
Operationalizing MISP Threat Feeds
Enhance threat detection with curated MISP feeds.
