Content
75%Weight 40%Scale 1-5Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The body is an efficient, code-heavy reference with concrete rules, commands, and a valuable pitfalls table, plus a mass-hunt workflow that includes explicit validation checkpoints. Remaining gaps are minor: a few placeholder or comment-only blocks, no executable commands for the validation steps, and an unlinked references section.
Suggestions
Add concrete validation commands to the workflow's test steps (e.g. `yara rule.yar sample.exe` and `yara -r rules/ clean_corpus/`) so the must-match/must-NOT-match checkpoints are executable.
Replace the comment-only VirusTotal Retrohunt block with an actual submission step or a link to the Retrohunt UI, and flesh out `hash.sha256(...)` placeholders.
Turn the terminal "References" section into actionable links/paths, and consider moving detailed module syntax (PE/ELF/hash/math) into a `references/` file.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and code-first — a complete annotated rule, a compact condition-tools snippet, a dense pitfalls table, and terse tool lists. Minor trimmable padding remains: editorial asides ("the canonical YARA author of our era") and a comment-only VT Retrohunt block. | 4 / 5 |
Actionability | Mostly executable guidance: full YARA rules, a concrete MalwareBazaar `curl` command, and local scan commands (`yara -r rules/ /samples/`, `capa`). Minor gaps: the Retrohunt section is comments only, `hash.sha256(0, filesize) == "..."` is a placeholder, and the workflow's test steps lack concrete commands. | 4 / 5 |
Workflow Clarity | The mass-hunt workflow is clearly sequenced with explicit validation checkpoints — "must match" the known sample and "must NOT match" clean and cross-family corpora — plus an iterate step. Minor gaps: the validation steps don't include runnable commands, and step 1 references a `reverser/malware-triage` skill not present in this bundle. | 4 / 5 |
Progressive Disclosure | A single self-contained file with no bundle directories; sections are well-organized and headers make navigation easy at this size. Minor gaps: detailed module/condition syntax could live in a reference file, and the terminal "References" section lists unlinked titles rather than actionable paths or URLs. | 4 / 5 |
Total | 16 / 20 Passed |