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-sampleWrites to ~/.notholy/skills after checking the signature and the SHA-256.
SignatureSigned, ed25519
Packagef1473edb…4aef2477
f1473edbe30d…94134aef24774 files · 4.3 KBScanMedium3 findings
- Executable script shipped with the skillscripts/analyst.py
- command.base64_execscripts/analyst.py:33
- Links to outside domains
Sourcegithub.com/meltedinhex/analyst-ai-pack/tree/main/skills/triaging-an-unknown-sample@da7600a
On this page
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:
python scripts/analyst.py triage sample.bin
# reports: detected type, magic, hashes, entropy, suspicious stringsA .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:
python scripts/analyst.py reputation --sha256 <sha256> --vt-key $VT_API_KEYKnown-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:
entropy ~7.9 / 8.0 over most of the file -> likely packed/encrypted
mixed entropy with readable strings -> likely unpackedStep 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.mdfor the triage tool and scoring logic. - libmagic and VirusTotal API documentation (linked in frontmatter).
Files in this version
references/11.6 KB
- api-reference.md1.6 KB
scripts/13.8 KB
- analyst.py3.8 KB
- LICENSE340 B
- SKILL.md3.9 KB
Permissions
| Permission | Declared | Found by the scan |
|---|---|---|
| Reads files | Yes | Yes |
| Writes files | Yes | Yes |
| Runs shell commands | Yes | Yes |
| Uses the network | Yes | Yes |
| Uses connectors | No | No |
| Drives a browser | No | No |
Scan findings
Reviewed on Nov 13, 2026
- MediumFile · Executable script shipped with the skillscripts/analyst.py
- MediumCommand · command.base64_execscripts/analyst.py:33
- InfoLink · Links to outside domains
A clean scan lowers the risk but does not prove a package is safe. Read what you install.
| Version | Published | Commit | SHA-256 | Signature | Permission change |
|---|---|---|---|---|---|
| v1.0.0 | Nov 13, 2026 | da7600a | f1473edb | Signed | – |
More from meltedinhex
All from this publisher- writing-yara-rules-from-reversed-codemeltedinhex/writing-yara-rules-from-reversed-code4
- validating-detections-with-atomic-testsmeltedinhex/validating-detections-with-atomic-tests4
- writing-suricata-and-snort-rulesmeltedinhex/writing-suricata-and-snort-rules3
- writing-sigma-detection-rulesmeltedinhex/writing-sigma-detection-rules3
More in Malware and ransomware analysis
See the category- yara-sigsdariushoule/yara-sigs4
- monitoring-darkweb-sourcesmukul975/monitoring-darkweb-sources3
- deploying-ransomware-canary-filesmukul975/deploying-ransomware-canary-files3
- implementing-honeypot-for-ransomware-detectionmukul975/implementing-honeypot-for-ransomware-detection3
- yaraaeondave/yara3
- testing-ransomware-recovery-proceduresmukul975/testing-ransomware-recovery-procedures3
Ask anything your scope allows.
Create an account, add credits and ask the first question in the chat or the terminal.
- 1/3
Create the account
Individual or company. You can switch to a company later without losing balance or keys.
IndividualCompany - 2/3
Add credits
By card. Pay per token, no subscription.
$5.00minimum deposit - 3/3
Ask
In the chat, or install the CLI and run notholy login in your terminal.
$ notholy login