Skip to content
Skillpedia
Analysis & spreadsheets35k · #5784

hunting-evtx-with-chainsaw

Makes your agent analyze Windows log files to find threats quickly, even without a central monitoring system. It helps investigate incidents and generate reports.

What it does

This tool helps search for suspicious activity within Windows event log files (.evtx). It uses security rules to find threats and can analyze specific system information.

When to use it

  • ✓When investigating a security incident on computers not connected to the internet.
  • ✓When you need to quickly find evidence of an attack using log files.
  • ✓To search for specific patterns or suspicious commands within logs.

Example of what to ask your AI

“Search for suspicious activity in the collected log files.”

Want more? Open the sections below.

How to use

The easiest way: copy the message below and paste it into Claude, ChatGPT, Cursor or any AI. It reads the skill and follows the instructions.

Skill link

https://github.com/mukul975/Anthropic-Cybersecurity-Skills/blob/main/skills/hunting-evtx-with-chainsaw/SKILL.md

Ready-to-paste message

Use this skill to help me: https://github.com/mukul975/Anthropic-Cybersecurity-Skills/blob/main/skills/hunting-evtx-with-chainsaw/SKILL.md Read the SKILL.md file at that link and follow its instructions for my task.
How it works

The tool reads Windows log files and compares them against a set of security rules. It can also search for specific keywords or patterns you define.

Installation

Easiest way: copy the skill link and paste it into Claude, ChatGPT or Cursor asking it to follow the instructions.

In the terminal (Claude Code, Codex, Cursor), in your project folder:

npx skills add mukul975/Anthropic-Cybersecurity-Skills --skill hunting-evtx-with-chainsaw

Or download just the file:

curl -L https://raw.githubusercontent.com/mukul975/Anthropic-Cybersecurity-Skills/main/skills/hunting-evtx-with-chainsaw/SKILL.md -o SKILL.md
Technical content (original SKILL.md)

Original text by the author, straight from GitHub.

Hunting EVTX with Chainsaw

Overview

Chainsaw is a fast, Rust-based forensic artifact search and hunting tool from WithSecure Labs. It provides first-response capability to rapidly identify threats within Windows Event Logs (.evtx) and other artifacts. Chainsaw can hunt with the full SigmaHQ rule corpus (translating Sigma to its internal Tau engine), run its own built-in detection rules, perform high-speed keyword/regex search across logs, and analyse specialized artifacts such as the AppCompatCache (shimcache), SRUM database, and event-log gaps. Output can be a colorized table, CSV, or JSON for downstream tooling.

Chainsaw's strength is speed and flexibility during initial triage: an analyst can drop a folder of collected EVTX onto the tool and get back a prioritized set of detections in seconds, then pivot with targeted search queries to confirm a hypothesis. Unlike a SIEM, it needs no ingestion pipeline, runs as a single binary, and works fully offline against acquired evidence — ideal for the field or an air-gapped analysis VM. The --mapping file tells Chainsaw how Sigma fields translate to Windows event fields, which is what enables broad Sigma coverage over EVTX.

A common hunt outcome is detecting suspicious PowerShell — MITRE ATT&CK T1059.001 (Command and Scripting Interpreter: PowerShell) — by running Sigma rules against PowerShell operational logs (Event ID 4104 script-block logging) or searching for encoded-command patterns. This skill maps to NIST CSF DE.AE-02 (potentially adverse events are analyzed to better understand associated activities).

When to Use

  • During first-response triage to rapidly hunt threats across collected Windows event logs.
  • When you need offline Sigma-based detection over .evtx without standing up a SIEM.
  • To run fast keyword/regex searches confirming or refuting a hunt hypothesis.
  • To analyse shimcache, SRUM, or event-log time gaps for execution evidence and tampering.
  • To produce CSV/JSON detection output for reporting or pipeline ingestion.

Prerequisites

  • Chainsaw binary. Download a release from GitHub or build from source:
    # Build from source (Rust toolchain required)
    git clone https://github.com/WithSecureLabs/chainsaw.git
    cd chainsaw && cargo build --release
    ./target/release/chainsaw --version
    # or: nix profile install github:WithSecureLabs/chainsaw
    
  • The Chainsaw repo ships mappings/ (Sigma field mappings) and rules/ (Chainsaw rules).
  • A copy of the SigmaHQ rules for full Sigma coverage:
    git clone https://github.com/SigmaHQ/sigma.git
    
  • Collected Windows .evtx files (and registry hives like SYSTEM/Amcache.hve for shimcache analysis).

Objectives

  • Hunt collected EVTX with Sigma rules using the correct mapping file.
  • Filter detections by rule level, status, and kind to reduce noise.
  • Search logs by keyword, regex, and Tau expression for targeted confirmation.
  • Output detections as table, CSV, and JSON.
  • Analyse shimcache (with Amcache timestamp pairing), SRUM, and event-log gaps.

MITRE ATT&CK Mapping

Technique ID Official Name Why Chainsaw Detects It
T1059.001 Command and Scripting Interpreter: PowerShell Sigma rules over EID 4104/4103 and search flag malicious PowerShell
T1059.003 Command and Scripting Interpreter: Windows Command Shell Process-creation Sigma rules surface suspicious cmd usage
T1547.001 Boot or Logon Autostart Execution: Registry Run Keys / Startup Folder Sigma rules over registry events flag persistence
T1053.005 Scheduled Task/Job: Scheduled Task Rules over EID 4698/106 detect task creation
T1070.006 Indicator Removal: Timestomp analyse gaps and shimcache analysis reveal tampering/time gaps
T1204.002 User Execution: Malicious File Shimcache analysis shows executed binaries

Workflow

1. Hunt EVTX with Sigma rules

Run the SigmaHQ corpus against collected logs using the bundled mapping file. The mapping translates Sigma fields to EVTX fields.

chainsaw hunt ./collected_evtx \
  -s ./sigma/rules \
  --mapping ./mappings/sigma-event-logs-all.yml

2. Hunt with Chainsaw built-in rules plus Sigma

Combine Chainsaw's own rules (-r) with Sigma (-s) for broader coverage.

chainsaw hunt ./collected_evtx \
  -r ./rules \
  -s ./sigma/rules \
  --mapping ./mappings/sigma-event-logs-all.yml

…

FAQ

What are .evtx files?

.evtx files record important events that happen on a Windows computer, such as logins, program executions, and errors.

What are Sigma rules?

Sigma rules are a set of patterns that describe known malicious activities, used to detect threats in logs.

Do I need special software to use this?

Yes, you need to download and install the 'Chainsaw' tool and have the Windows log files (.evtx) you want to analyze.

Details

Original description by the author

Run Chainsaw against collected Windows EVTX files to hunt with the SigmaHQ rule corpus, built-in detection rules, and high-speed keyword/regex search, plus analyze shimcache, SRUM, and event-log gaps, outputting colorized tables, CSV, or JSON. Use during first-response triage for offline, SIEM-free detection over Windows event logs, or to quickly confirm a hunt hypothesis and produce reporting out

repo: mukul975/Anthropic-Cybersecurity-Skills

Popularity

GitHub stars
35k
Ranking position
#5784
License
Apache-2.0
Updated
8/31/2026

Is this skill useful?

0

Sign in to vote.

Comments

  • …

More skills from this repository

Similar skills