drift-watcher

Detect recurring cron and launchd job failures from recent logs and emit structured drift incidents.

Updated Jun 23, 2026
One-click install
npx skills add https://github.com/Walliiee/agent-harness --skill drift-watcher
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: drift-watcher
Source: https://github.com/Walliiee/agent-harness/tree/main/skills/drift-watcher
Command: npx skills add https://github.com/Walliiee/agent-harness --skill drift-watcher

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill detects recurring cron and launchd job failures early so operational drift can be routed into an incident pipeline instead of silently accumulating.

Core Features & Use Cases

  • Failure signature detection: Scans recent launchd stdout and stderr logs for known error patterns such as repeated failures, timeouts, and missing artifacts.
  • Incident emission: Converts matched failures into structured drift incidents for downstream analysis, notification, and recovery workflows.
  • Recovery awareness: Resets green-path counters when a previously failing job starts succeeding again.
  • Use case: An hourly sweep finds a broken background job, emits the incident automatically, and helps a team respond before the issue becomes a larger outage.

Quick Start

Ask the agent to run the drift-watcher sweep against recent launchd logs and emit any matching drift incidents.

Frequently Asked Questions about drift-watcher

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I detect recurring cron job failures from logs before they cause an outage?

To detect recurring cron job failures, you need a tool that scans recent stdout and stderr logs for error patterns like timeouts and repeated failures. This process converts matched logs into structured incidents for routing into recovery workflows.

What is drift monitoring for background jobs and when do I need it?

Drift monitoring for background jobs is the process of catching recurring launchd or cron failures early. You need it during hourly operational sweeps to prevent silent error accumulation from cascading into larger operational outages.

How do I monitor launchd job failures and automatically emit incidents?

You monitor launchd job failures by running an automated sweep against recent log output to match error signatures. Upon detection, the system emits structured drift incidents automatically for downstream analysis and notification.

Can I reset failure counters for cron jobs when a previously failing job recovers?

Yes, you can reset failure counters when a previously failing cron job starts succeeding again. This recovery awareness behavior resets green-path counters to ensure recovered jobs no longer trigger drift incidents.

Does this approach work for postmortem routing in agent-managed environments?

Yes, this approach works for postmortem routing in agent-managed environments by applying hourly operational sweeps to background jobs. It structures recurring failures into incidents, enabling agents to route recovery workflows efficiently.