macos-forensics — Claude Code skill: what it does, how to install
macos-forensics is a Claude Code skill that inspects host artefacts during incident response on Apple operating systems. It coordinates unified log traces, FSEvents records and TCC databases.
no license ★ 73 updated 2026-11-15
npx skills add W4L33Dx/Cyber-Monster --skill macos-forensics -a claude-codeWhat macos-forensics does
The skill correlates digital evidence across disparate storage mechanisms on Apple machines. It parses unified logs stored as tracev3 data under /private/var/db/diagnostics/ and connects them with file system modification streams in FSEvents. Since FSEvents batches record monotonically rising IDs without discrete wall-clock timestamps, the skill binds them to flush timestamps and external references.
It inspects download paths by linking com.apple.quarantine attributes to QuarantineEventsV2 via matching identifiers. The workflow handles timestamp conversions between Mac absolute time and Unix epochs. It also audits user and system TCC databases. Grants found without corresponding prompt traces in the unified log are flagged as anomalies.
On active hosts, triage requires gathering a sysdiagnose archive and running log collect before any reboot. SQLite tables must be retrieved alongside -wal and -shm sidecars, then inspected with immutable=1. When log coverage is missing or incomplete, the skill mandates an inconclusive telemetry gap classification instead of a clean verdict.
What it helps with
- reconstruct process executions using the unified log and Rosetta 2 caches
- sequence file system alterations through FSEvents identifiers
- identify suspicious privacy authorizations across system and user TCC tables
- link quarantined files to their download metadata in QuarantineEventsV2
- inspect persistence configurations across LaunchAgents and LaunchDaemons
Example prompts for the agent
- Examine the TCC databases and flag grants that have no corresponding prompt events in the unified log.
- Reconstruct the download timeline by correlating com.apple.quarantine attributes with QuarantineEventsV2.
- Inspect launchd plists and unified log entries for evidence of unauthorized persistence.
How to install macos-forensics
1Skills CLI (Vercel)
npx skills add W4L33Dx/Cyber-Monster --skill macos-forensics -a claude-code2Manually: put the files in place
~/.claude/skills/macos-forensics/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/macos-forensics/
1Skills CLI (Vercel)
npx skills add W4L33Dx/Cyber-Monster --skill macos-forensics -a codex2Manually: put the files in place
.agents/skills/macos-forensics/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add W4L33Dx/Cyber-Monster --skill macos-forensics -a cursor2Manually: put the files in place
.cursor/skills/macos-forensics/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install W4L33Dx/Cyber-Monster blue-team/digital-forensics/macos-forensics2Manually: put the files in place
.github/skills/macos-forensics/SKILL.md1Skills CLI (Vercel)
npx skills add W4L33Dx/Cyber-Monster --skill macos-forensics -a gemini-cli2Platform CLI
gemini skills install https://github.com/W4L33Dx/Cyber-Monster --path blue-team/digital-forensics/macos-forensicsManually: put the files in place
.devin/skills/macos-forensics/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about macos-forensics
How do I install macos-forensics in Claude Code?
Run npx skills add W4L33Dx/Cyber-Monster --skill macos-forensics -a claude-code. Alternatively, place the skill file directly into ~/.claude/skills/macos-forensics/SKILL.md.
What does macos-forensics do?
It provides systematic inspection workflows for Apple endpoint investigations. The skill standardizes evidence parsing across unified logs, FSEvents records, quarantine tracking and launchd persistence files.
What is required when handling SQLite forensic artefacts with this skill?
You need to extract SQLite databases together with their -wal and -shm sidecar files. Open the copies using immutable=1 to prevent write operations during artifact analysis.