# Charlie Quote Verification
> Methodology for verifying Charlie chatbot quotes and timestamps in blog posts using YouTube live chat replay data
- Skill: `fritzandfriends/charlie-quote-verification` (Agent Skill)
- Install (CLI): `npx skillmds@latest add fritzandfriends/charlie-quote-verification`
- Raw SKILL.md: https://api.skillmd.com/api/skills/fritzandfriends/charlie-quote-verification/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: fritzandfriends (https://skillmd.com/u/fritzandfriends)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/fritzandfriends/charlie-quote-verification
---
## Context
When blog posts document Charlie the chatbot's transmissions with timestamps and quotes, we need a verified connection between the text and the actual YouTube stream where Charlie appeared. The challenge: Charlie's messages appear in Twitch chat first, then are relayed to YouTube chat by a restream bot with a specific format. We must extract the exact moment Charlie appeared and verify timestamps are accurate within ~1 minute tolerance. This skill provides the repeatable methodology for Week N verification work.
## Patterns
### Primary Method: Live Chat Replay Download
**Tool:** `yt-dlp` (installed at `C:\Users\jefritz\AppData\Local\Python\pythoncore-3.14-64\Scripts\yt-dlp.exe`)
**Command template:**
```bash
yt-dlp --skip-download --write-sub --sub-lang "live_chat" --sub-format json -o "{output_dir}/{video_id}" "https://www.youtube.com/watch?v={VIDEO_ID}"
```
**Chat JSON file structure:** The output is a JSONL file (one JSON object per line). Each line contains a replay chat item with these key fields:
```json
{
"replayChatItemAction": {
"videoOffsetTimeMsec": 1800000,
"actions": [{
"addChatItemAction": {
"item": {
"liveChatTextMessageRenderer": {
"message": {
"runs": [{"text": "...message content..."}]
},
"authorName": {
"simpleText": "username"
}
}
}
}
}]
}
}
```
**Key fields for Charlie verification:**
- `replayChatItemAction.videoOffsetTimeMsec` — milliseconds since video start (THE critical timing field)
- `replayChatItemAction.actions[].addChatItemAction.item.liveChatTextMessageRenderer.message.runs[].text` — message content (concatenate all `runs` to get full text)
- `replayChatItemAction.actions[].addChatItemAction.item.liveChatTextMessageRenderer.authorName.simpleText` — sender name
### Finding Charlie Messages in Chat
**Relay format:** Charlie messages from Twitch (`charliebotai` bot) are relayed to YouTube chat by `@restreambot4225` with this format:
```
[Twitch: charliebotai] {message text}
```
**Search strategy:**
1. Filter the chat JSON for lines containing `"charliebotai"` (case-insensitive)
2. Extract `videoOffsetTimeMsec` from each match
3. Convert milliseconds to seconds and minutes: `seconds = offset_ms / 1000`, `minutes = int(seconds // 60)`
### The csharpTrace Marker Pattern (Critical for Blog Timestamps)
**Pattern:** Chat messages containing the string `csharpTrace` are KEY TIMING MARKERS for when Charlie's narrative appears in the stream.
**Why it matters:** The actual narrative quotes in the blog (e.g., "Anomaly detected...") are authored fiction by the team and do NOT appear verbatim in chat. The `csharpTrace` messages are the closest identifiable signal for when Charlie "appears" or becomes active in the stream context.
**Alignment:** `csharpTrace` timestamps closely match the blog's "X-minute mark" timestamps, typically within ±1 minute tolerance. This is how we verify that a blog post's claimed 30-minute transmission actually occurred near the 30-minute mark in the video.
**Example alignment (Week 8):**
- Blog claims: "30-minute mark"
- Actual `csharpTrace` in chat: 30:12 (1800 seconds) ✅
- Blog claims: "90-minute mark"
- Actual `csharpTrace` in chat: 90:12 (5412 seconds) ✅
### Embedding YouTube Timestamps in Blog Posts
**Formula for embed start parameter:**
```
start = floor(videoOffsetTimeMsec / 1000) - 4
```
**Why -4 seconds?** This gives viewers 3-5 seconds of lead-in before Charlie's message drops in chat. Viewers see the build-up to Charlie's appearance rather than starting in the middle of a message.
**Example:**
- `csharpTrace` at 1800000 ms (30:00) → `start = floor(1800000 / 1000) - 4 = 1796` → embed with `?start=1796`
- Video plays from 29:56, giving 4 seconds before the 30:00 message
**Embed code template (iFrame format used in signal-archive):**
```html
```
### Python Script for Extracting Charlie Messages
Use this pattern to extract all `charliebotai` messages from a chat JSON file:
```python
import json
def extract_charlie_messages(chat_json_file):
results = []
with open(chat_json_file, 'r', encoding='utf-8') as f:
for line in f:
try:
data = json.loads(line)
except json.JSONDecodeError:
continue
actions = data.get('replayChatItemAction', {}).get('actions', [])
offset_ms = int(data.get('replayChatItemAction', {}).get('videoOffsetTimeMsec', 0))
for action in actions:
renderer = action.get('addChatItemAction', {}).get('item', {}).get('liveChatTextMessageRenderer', {})
if renderer:
author = renderer.get('authorName', {}).get('simpleText', '')
msg_parts = renderer.get('message', {}).get('runs', [])
msg = ''.join(part.get('text', '') for part in msg_parts)
# Check for Charlie indicators
if 'charliebotai' in msg.lower() or 'charliebotai' in author.lower():
secs = offset_ms / 1000
mins = int(secs // 60)
# Flag if this message contains the csharpTrace timing marker
has_trace = 'csharpTrace' in msg
results.append({
'offset_ms': offset_ms,
'seconds': secs,
'minutes': mins,
'minutes_seconds': f"{mins}:{int(secs % 60):02d}",
'message': msg,
'is_timing_marker': has_trace
})
return results
```
### Secondary Method: Playwright Screenshots (Video Element Only)
**Purpose:** Capture visual snapshots of the video player at each transmission moment. Extract **video element only**, explicitly excluding YouTube header, sidebar, chat, recommendations, comments, overlays, and browser chrome.
**Selectors and Element Structure:**
- Primary video element selector: `.html5-main-video` (the actual video `