# Proactive Agent

> Autonomous proactive agent that monitors conditions and triggers actions - watches for file changes, error patterns, performance thresholds, and schedules periodic checks without user intervention

- Skill: `chainlesschain/proactive-agent` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add chainlesschain/proactive-agent`
- Raw SKILL.md: https://api.skillmd.com/api/skills/chainlesschain/proactive-agent/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Web & Frontend
- License: MIT
- Author: chainlesschain (https://skillmd.com/u/chainlesschain)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/chainlesschain/proactive-agent

---


# Proactive Agent Skill

Autonomous monitoring and proactive action execution.

## Usage

```
/proactive-agent watch <path> --on-change "<command>"
/proactive-agent threshold <metric> --above <value> --action "<command>"
/proactive-agent periodic <interval> "<command>"
/proactive-agent pattern <file> --match "<regex>" --action "<command>"
/proactive-agent list
/proactive-agent stop <watcher-id>
```

## Trigger Types

| Type | Description | Example |
| --- | --- | --- |
| `watch` | File/directory change detection | Watch `src/` and run tests |
| `threshold` | Metric threshold alerts | Alert when memory > 80% |
| `periodic` | Interval-based execution | Check API health every 30min |
| `pattern` | Log/file pattern matching | Detect ERROR in log files |

## Watch Mode

Monitors filesystem for changes using native OS watchers:

```
/proactive-agent watch src/ --on-change "npm test"
/proactive-agent watch config/ --on-change "/lint-and-fix"
```

## Threshold Mode

Monitors system metrics against thresholds:

```
/proactive-agent threshold cpu --above 80 --action "alert"
/proactive-agent threshold memory --above 90 --action "/system-monitor"
```

## Periodic Mode

Runs actions at regular intervals:

```
/proactive-agent periodic 30m "curl -s http://localhost:3000/health"
/proactive-agent periodic 1h "/security-audit --quick"
```

## Pattern Mode

Watches files for regex pattern matches:

```
/proactive-agent pattern logs/app.log --match "ERROR|FATAL" --action "alert"
/proactive-agent pattern access.log --match "status=5\\d{2}" --action "/log-analyzer"
```

## Management

```
/proactive-agent list          # List all active watchers
/proactive-agent status <id>   # Show watcher details
/proactive-agent stop <id>     # Stop a specific watcher
/proactive-agent stop all      # Stop all watchers
```