Skip to content

meltedinhex/analyst-ai-pack / skills/pivoting-on-iocs-across-data-sources

pivoting-on-iocs-across-data-sources

Verified

Pivots on indicators of compromise across multiple data sources by correlating a seed set of IOCs against logs to find co-occurring indicators, hosts, and timeframes that expand the investigation. Activates for requests to pivot on IOCs, correlate indicators across data sources, or expand an investigation from a seed indicator set.

FileKindSize
LICENSEother340 B
SKILL.mdskill md2.6 KB
references/api-reference.mdmarkdown1.1 KB
scripts/analyst.pyscript3.4 KB

references/api-reference.md

View on GitHub
# API Reference: Pivoting on IOCs Across Data Sources

## Overview

`scripts/analyst.py` matches log records against a seed IOC set, then reports co-occurring hosts, the
activity time range, and new indicators ranked by co-occurrence with the seeds. It refangs input
for matching, defangs output, parses data only, and executes nothing.

## Dependencies

| Package | Version | Purpose |
|---------|---------|---------|
| (stdlib) | — | csv, json, regex, Counter, file IO |

## Core functions

### `pivot(seeds_path, logs_path)`
Returns matched record count, affected hosts, time range, and ranked new indicators.

### `_indicators(text)`
Extracts IPs, domains, and hashes from a text blob.

## Inputs

- **seeds**: one IOC per line (plain or defanged; refanged internally).
- **logs**: CSV or JSON-lines records.

## Usage

```bash
python scripts/analyst.py pivot --seeds iocs.txt --logs events.csv
```

## Sources

- Pyramid of Pain (indicator pivoting value) — https://www.sans.org/
- MITRE ATT&CK techniques — https://attack.mitre.org/techniques/
- Seed-anchored co-occurrence pivoting from public investigation/IR practice
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 194kUpdated Claude CodeCodexVerifiedInstall