AI agent skill · by @SpecterOps

Timeline Pdf Notes

Extract timeline entries from PDF operator notes via pdfplumber.

Archived 2026-10-23 · Source updated 2026-09-23 · License: Apache-2.0. Check the original repository for the latest version.

SKILL.md instructions

# Timeline PDF Notes Parser

Use when provided operator notes are only available as PDFs.

## Input Contract
- Directory `input/notes/` with `.pdf` files representing operator notes.

## Output
- Write `output/pdf_notes_entries.json` with normalized entries (timestamp, source, operator, action, details, raw_timestamp).

## Workflow
1. Use `pdfplumber` to extract text per page and optional tables.
2. Apply the same timestamp patterns as the Markdown parser; use filename-derived dates/operator context when necessary.
3. Normalize timestamps to UTC and drop duplicates flagged by the consolidator.
4. Track page numbers or table origins in `source`/`details` for traceability.
5. Append `source_type = "pdf_notes"` in metadata with counts and errors.
6. Provide guidance to install `pdfplumber` if missing.

## Notes
- Tables are optional; parse them to capture structured timeline rows when available.
- Handle messy text by cleaning repeated headers/footers.