maxwellokumu/okaudit-claude-skills / log-monitoring/incident-timeline-builder
incident-timeline-builder
VerifiedReconstruct incidents from log data into a clear chronological timeline so Claude can explain what happened, when it happened, and which actors or indicators matter most.
| File | Kind | Size |
|---|---|---|
| README.md | markdown | 1.3 KB |
| SKILL.md | skill md | 1.7 KB |
| main.py | script | 9.6 KB |
| sample_input/incident_logs.jsonl | other | 5.7 KB |
| skill.yaml | config | 1.1 KB |
README.md
View on GitHub# incident-timeline-builder
Build a chronological incident timeline from log files, grouped by hour with
suspicious events flagged. Supports actor filtering, date range scoping, and
JSON output for downstream processing.
---
## Requirements
```bash
pip install python-dotenv
```
---
## Usage
```bash
# Full timeline
python main.py --logs sample_input/incident_logs.jsonl
# Filter by time window
python main.py \
--logs sample_input/incident_logs.jsonl \
--start "2025-07-01T09:00:00" \
--end "2025-07-01T15:00:00"
# Filter by actor
python main.py \
--logs sample_input/incident_logs.jsonl \
--actor "root"
# JSON output
python main.py \
--logs sample_input/incident_logs.jsonl \
--output json
# Combine filters
python main.py \
--logs sample_input/incident_logs.jsonl \
--actor "203.0.113.5" \
--start "2025-07-01T00:00:00" \
--output json
```
---
## Sample Output (truncated)
```markdown
# Incident Timeline Report
**Total Events:** 40
**Flagged Events:** 12
## 2025-07-01 09:00 — 4 event(s)
- 🚨 `2025-07-01T09:30:00` | `root` [203.0.113.5] | **RootAccountUsage** → `iam`
- 🚨 `2025-07-01T09:35:00` | `root` [203.0.113.5] | **DeleteTrail** → `cloudtrail:::audit-trail`
- ✅ `2025-07-01T09:10:00` | `alice` [10.0.0.1] | **PutObject** → `s3:::prod-bucket`
```
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| 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: 198k | Updated | Claude CodeCodex | Verified | Install |
| 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: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| 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: 194k | Updated | Claude CodeCodex | Verified | Install |