cron-doctor

> **Compatible with Claude Code, Codex CLI, Cursor, Windsurf, and any SKILL.md-compatible agent.**

# Cron Doctor

Diagnose and triage cron job failures.

## Usage

When asked to check cron health or diagnose failures:

### 1. List All Jobs

```bash
# List user's crontab
crontab -l

# List system crontabs
sudo cat /etc/crontab
ls -la /etc/cron.d/
```

### 2. Check Recent Execution

```bash
# Check cron logs (location varies by system)
# Debian/Ubuntu:
grep CRON /var/log/syslog | tail -50

# RHEL/CentOS:
tail -50 /var/log/cron

# macOS:
log show --predicate 'process == "cron"' --last 1h

# Check for specific job output
grep "your_job_name" /var/log/syslog | tail -20
```

### 3. Identify Problems

**Error patterns to watch:**
- `"command not found"` — Missing executable or PATH issue
- `"Permission denied"` — File/directory permissions wrong
- `"No such file or directory"` — Script path incorrect
- `"timeout"` — Job took too long
- `"ECONNREFUSED"` — Network/service down
- `"rate limit"` — API throttling
- Missing output — Job may not be running at all

### 4. Triage Priority

| Priority | Criteria |
|----------|----------|
| 🔴 Critical | Trading, backup, security jobs |
| 🟠 High | User-facing deliveries |
| 🟡 Medium | Monitoring, research jobs |
| 🟢 Low | Nice-to-have, non-essential |

### 5. Generate Report

Write to `~/workspace/reports/cron-health-YYYY-MM-DD.md`:

```markdown
# Cron Health Report - [DATE]

## Summary
- ✅ Healthy: X jobs
- ⚠️ Warning: X jobs  
- ❌ Failed: X jobs

## Failed Jobs

### [Job Name]
- **Error:** [message]
- **Last Success:** [date]
- **Priority:** [level]
- **Fix:** [suggested action]

## Recommendations
1. [Action item]
2. [Action item]
```

### 6. Common Fixes

| Error | Fix |
|-------|-----|
| Command not found | Use full path to executable, or set PATH in crontab |
| Permission denied | Check file permissions, run `chmod +x script.sh` |
| No output | Add `>> /tmp/job.log 2>&1` to capture output |
| Wrong timezone | Set `TZ=` in...

# Cron Doctor

**Diagnose and triage your cron jobs like a pro.**

When scheduled tasks fail, Cron Doctor quickly identifies the problem, categorizes by severity, and suggests fixes. It generates clean health reports so you always know the state of your automation.

Perfect for anyone running background jobs, scheduled backups, or automated workflows.

## Platform Support

**Works on:** Claude Code, Codex CLI, Cursor, Windsurf, and any SKILL.md-compatible agent.

**Enhanced features available on some platforms:**
- Managed cron system with built-in state tracking
- Execution history without log parsing
- Sub-agent auto-escalation for critical failures

---

## Premium Skills

Want more? Check out our premium skills at **[skillpacks.dev](https://skillpacks.dev)**:

- 🛡️ **Security Suite** — PII scanning, secrets detection, prompt injection defense — [$9.90](https://polycatai.gumroad.com/l/bsrugo)
- 🧠 **Structured Memory** — Three-tier memory replacing flat MEMORY.md — [$9.90](https://polycatai.gumroad.com/l/goawrg)
- 📋 **Planning & Execution** — Systematic task plans with batch execution — [$9.90](https://polycatai.gumroad.com/l/uydfto)
- 💎 **[Bundle — all 3 for $24.90](https://polycatai.gumroad.com/l/atsrl)**