Skip to content

meltedinhex/analyst-ai-pack / skills/enriching-iocs-with-threat-intel-sources

enriching-iocs-with-threat-intel-sources

Verified

Enriches indicators with context from threat-intel sources: planning lookups against reputation, passive DNS, WHOIS, and sandbox/sample databases, scoring confidence, and avoiding operational-security mistakes that tip off adversaries. Activates for requests to enrich IOCs, add threat context, or plan indicator lookups safely.

FileKindSize
LICENSEother340 B
SKILL.mdskill md3.2 KB
references/api-reference.mdmarkdown1.0 KB
scripts/analyst.pyscript2.1 KB

scripts/analyst.py

View on GitHub
#!/usr/bin/env python3
"""Plan passive enrichment lookups for a set of indicators.

Reads a JSON object of typed indicators and maps each to appropriate passive enrichment sources,
flagging operational-security cautions (e.g., do not actively resolve). It produces a lookup
plan only; it performs no network requests itself, keeping enrichment opsec-safe by design.
"""
from __future__ import annotations

import argparse
import json
import sys
from pathlib import Path

SOURCE_MAP = {
    "hashes": ["sample/AV database (passive)", "sandbox report history"],
    "domains": ["passive DNS", "WHOIS/registration", "domain reputation"],
    "ipv4": ["ASN/geo lookup", "passive DNS (reverse)", "IP reputation"],
    "urls": ["URL reputation", "sandbox URL history"],
    "emails": ["breach/registration data", "phishing reputation"],
}

OPSEC = {
    "domains": "do NOT resolve from your own network; use passive DNS",
    "urls": "do NOT visit; use passive URL intel/sandbox history",
    "ipv4": "avoid active scanning that reveals your interest",
    "hashes": "do not upload sensitive samples to public sandboxes without authorization",
}


def plan(indicators: dict) -> dict:
    out = []
    for kind, values in indicators.items():
        if not values:
            continue
        out.append({
            "type": kind,
            "count": len(values),
            "sources": SOURCE_MAP.get(kind, ["(no mapped source)"]),
            "opsec": OPSEC.get(kind, "use passive sources where possible"),
        })
    return {"lookup_plan": out,
            "principle": "passive enrichment only; corroborate across independent sources"}


def main(argv: list[str] | None = None) -> int:
    parser = argparse.ArgumentParser(description="Plan IOC enrichment lookups")
    sub = parser.add_subparsers(dest="cmd", required=True)
    p = sub.add_parser("plan")
    p.add_argument("file", help="JSON object of typed indicators")
    args = parser.parse_args(argv)
    raw = json.loads(Path(args.file).read_text(encoding="utf-8"))
    indicators = raw.get("indicators", raw)
    print(json.dumps(plan(indicators), indent=2))
    return 0


if __name__ == "__main__":
    sys.exit(main())
rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first.Stars: 194kUpdated Claude CodeCodexVerifiedInstall