computer-investigation

Automate security investigations for Entra ID and Defender for Endpoint devices.

231|64|Updated Dec 16, 2025
One-click install
npx skills add https://github.com/SCStelz/security-investigator --skill computer-investigation
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: computer-investigation
Source: https://github.com/SCStelz/security-investigator/tree/main/.github/skills/computer-investigation
Command: npx skills add https://github.com/SCStelz/security-investigator --skill computer-investigation

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill enables automated end-to-end security investigations of Windows, macOS, and Linux devices managed in Microsoft Entra ID and Defender for Endpoint. It consolidates Defender alerts, sign-in patterns, logged-on users, software inventory, vulnerabilities, network activity, and automated investigation tracking to identify threats, compliance gaps, and risky configurations.

Core Features & Use Cases

  • Unified device investigations: Collects Defender alerts, sign-ins, users, software inventory, vulnerabilities, and network activity for a single device.
  • Parallel data collection: Runs Graph API, Defender API, and Sentinel/KQL queries in parallel to reduce investigation time.
  • Automated reporting: Exports a JSON dossier and generates a concise risk-and-remediation summary for stakeholders.
  • Use Case: Investigate a Windows workstation suspected of compromise by aggregating alert history, sign-ins, and installed software.

Quick Start

Use the computer-investigation skill to initiate a full device security investigation for a target device like HOSTNAME or ENTRAD-DEVICE-01.

Frequently Asked Questions about computer-investigation

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate a security investigation for a device managed in Defender for Endpoint?

Automate a security investigation by running parallel Graph API, Defender API, and Sentinel KQL queries to aggregate alerts, sign-ins, and network activity for a target device. The skill collects this data automatically, exports a JSON dossier, and generates a risk-and-remediation summary report.

What data sources do I need for device-centric security investigations across Entra ID joined devices?

Device-centric security investigations require Graph API, Defender API, and Sentinel KQL access to collect Defender alerts, sign-in patterns, logged-on users, software inventory, vulnerabilities, and network activity across Entra Joined, Hybrid Joined, and Entra Registered devices.

Can I investigate macOS and Linux devices in Defender for Endpoint alongside Windows?

Yes, you can investigate Windows, macOS, and Linux devices managed in Entra ID and Defender for Endpoint. The skill consolidates alerts, sign-in patterns, and software inventory across all three operating systems into a unified JSON export and summary report.

How does parallel data collection speed up incident response for compromised workstations?

Parallel data collection accelerates incident response by executing Graph API, Defender API, and Sentinel queries simultaneously rather than sequentially. This reduces investigation time when aggregating alert history, sign-in logs, and installed software for a compromised Windows workstation.

What is the output format for an automated device security investigation?

The output format for an automated device security investigation is a single JSON dossier file containing all collected telemetry, accompanied by a concise risk-and-remediation summary report designed for stakeholder review.

Does this approach track automated investigations initiated by Defender for Endpoint alerts?

Yes, automated investigation tracking is included as part of the comprehensive device security investigation. The skill queries Defender for Endpoint to collect automated investigation status alongside alerts, vulnerabilities, and network activity for the target device.