# Timeline PDF Notes

> Extract timeline entries from PDF operator notes via pdfplumber.

- Skill: `specterops/timeline-pdf-notes` (Agent Skill, multi-file: 4 files)
- Install (CLI): `npx skillmds@latest add specterops/timeline-pdf-notes`
- Raw SKILL.md: https://api.skillmd.com/api/skills/specterops/timeline-pdf-notes/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: specterops (https://skillmd.com/u/specterops)
- Updated: 2026-09-21
- Page: https://skillmd.com/skills/specterops/timeline-pdf-notes

---


# 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.