# Analyst Watchdog

> Automated monitoring agent that watches an API scoreboard, detects milestones, writes findings to markdown, and alerts via file-based triggers. Use when you need an autonomous agent that monitors a system and produces structured analysis without human intervention.

- Skill: `modbender/analyst-watchdog` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add modbender/analyst-watchdog`
- Raw SKILL.md: https://api.skillmd.com/api/skills/modbender/analyst-watchdog/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: modbender (https://skillmd.com/u/modbender)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/modbender/analyst-watchdog

---


# Analyst Watchdog

An autonomous monitoring agent pattern: watch a system, detect changes, write findings, alert when thresholds are crossed. Runs on a schedule (LaunchAgent or cron) without human intervention.

## Pattern

```
API Endpoint → Poll → Detect Changes → Write FINDINGS.md
                                      → Write OUTBOX.md (for orchestrator)
                                      → Write ALERT_TELEGRAM.md (urgent)
```

## What It Monitors

Configurable, but the reference implementation tracks:
- Model evaluation scores hitting milestones (n=50, 100, 150, 200)
- Promotion events (model proven equivalent to cloud baseline)
- Score anomalies (sudden drops or improvements)
- System health degradation

## Alert Tiers

| File | Urgency | Who Reads It |
|---|---|---|
| `FINDINGS.md` | Low | Background knowledge |
| `OUTBOX.md` | Medium | Orchestrator on next heartbeat |
| `ALERT_TELEGRAM.md` | High | Sent immediately, then deleted |

## Files

- `scripts/analyst_agent.py` — Reference watchdog implementation