Skip to content
New

DeepSeek V4.1 Flash free for 7 days: 10M tokens a day after a top-up of $10 or more. Until Nov 30.

How it works
meltedinhex/triaging-an-unknown-sampleMalware and ransomware analysis

triaging-an-unknown-sample

⁨Performs fast first-pass triage of an unknown file to decide depth of analysis:⁩

v1.0.03 installs+3 in 7 days24 StarsApache-2.0synced 10 hours ago

Install

No NotHoly CLI yet? Install it first.

$ curl -fsSL https://notholy.com/install.sh | sh
$ notholy skills install meltedinhex/triaging-an-unknown-sample

Writes to ⁦~/.notholy/skills⁩ after checking the signature and the SHA-256.

SignatureSigned, ed25519
YCBSDmdKgL…FGr8fqDQ==The CLI checks the SHA-256 and the signature before it writes a file.
Packagef1473edb…4aef2477
f1473edbe30d…94134aef24774 files · ⁦4.3 KB⁩
ScanMedium3 findings
  • Executable script shipped with the skillscripts/analyst.py
  • command.base64_execscripts/analyst.py:33
  • Links to outside domains
See the full scan
Sourcegithub.com/meltedinhex/analyst-ai-pack/tree/main/skills/triaging-an-unknown-sample@da7600a

When to Use

  • A suspicious file has arrived and you need to quickly decide whether it warrants deep static/dynamic analysis or can be dismissed.
  • You want a structured first-pass record (type, hashes, packing, notable strings) before committing analyst time.
  • You are batch-triaging many files and need to rank them by suspicion.

Do not use triage results as a final verdict. A clean string review or unknown reputation does not mean benign; it means proceed to deeper analysis.

Prerequisites

  • file (libmagic) for type identification, or the bundled magic-based detection.
  • Optional VirusTotal API key for reputation (hash lookups only — never upload someone else's data without authorization).
  • The sample in a neutralized, non-executable form inside the lab.

Safety & Handling

  • Triage is static: read bytes, never execute. Keep the sample with a neutralized extension.
  • Submit only the hash to reputation services unless you have authorization to upload the file itself; uploads can expose sensitive or attributable data.

Workflow

Step 1: Identify the true file type

Do not trust the extension. Identify by magic bytes:

bash
python scripts/analyst.py triage sample.bin
# reports: detected type, magic, hashes, entropy, suspicious strings

A .pdf that is really a PE, or a .jpg that is a script, is itself a finding.

Step 2: Hash and check reputation

Compute the SHA-256 and look it up (hash-only) to see if it is known:

bash
python scripts/analyst.py reputation --sha256 <sha256> --vt-key $VT_API_KEY

Known-bad with many detections → escalate. Unknown → continue triage; absence of detections is not exoneration.

Step 3: Estimate packing via entropy

High, uniform entropy across the whole file or a code section suggests packing or encryption:

text
entropy ~7.9 / 8.0 over most of the file  -> likely packed/encrypted
mixed entropy with readable strings       -> likely unpacked

Step 4: Skim strings for quick signal

Look for URLs, IPs, registry paths, suspicious API names, and embedded PE headers (MZ). The script extracts and categorizes printable strings.

Step 5: Decide and record

Classify as: dismiss, deep static, or detonate. Emit a triage record for the case file.

Validation

  • The detected type matches the file's structure (e.g. PE confirmed by MZ/PE\0\0).
  • Entropy reading is consistent with the strings observed (packed files yield few readable strings).
  • The triage record captures type, hashes, entropy, reputation, and the escalation decision.

Pitfalls

  • Equating "0 detections on VirusTotal" with benign — fresh or targeted malware is often unknown.
  • Treating high entropy alone as proof of malice; installers and compressed media are also high-entropy. Combine signals.
  • Uploading samples to third parties without authorization, leaking sensitive data.
  • Stopping at triage for a file that is clearly suspicious but "not yet detected."

References

  • See references/api-reference.md for the triage tool and scoring logic.
  • libmagic and VirusTotal API documentation (linked in frontmatter).

Files in this version

Permissions

PermissionDeclaredFound by the scan
Reads filesYesYes
Writes filesYesYes
Runs shell commandsYesYes
Uses the networkYesYes
Uses connectorsNoNo
Drives a browserNoNo

Scan findings

Reviewed on Nov 13, 2026

  1. MediumFile · Executable script shipped with the skillscripts/analyst.py
  2. MediumCommand · command.base64_execscripts/analyst.py:33
  3. InfoLink · Links to outside domains

A clean scan lowers the risk but does not prove a package is safe. Read what you install.

VersionPublishedCommitSHA-256SignaturePermission change
v1.0.0Nov 13, 2026da7600af1473edbSigned–

Ask anything your scope allows.

Create an account, add credits and ask the first question in the chat or the terminal.

  1. 1/3

    Create the account

    Individual or company. You can switch to a company later without losing balance or keys.

    IndividualCompany
  2. 2/3

    Add credits

    By card. Pay per token, no subscription.

    $5.00minimum deposit
  3. 3/3

    Ask

    In the chat, or install the CLI and run notholy login in your terminal.

    $ notholy login