run-frequency-guard

Count daily skill executions from memory/token-usage.csv and alert when caps are exceeded.

626|225|Updated Mar 4, 2026
One-click install
npx skills add https://github.com/aaronjmars/aeon --skill run-frequency-guard
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: run-frequency-guard
Source: https://github.com/aaronjmars/aeon/tree/main/skills/run-frequency-guard
Command: npx skills add https://github.com/aaronjmars/aeon --skill run-frequency-guard

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It prevents runaway or unexpectedly frequent skill executions by detecting when any configured “capped” skills exceed their daily run limits and alerting you immediately.

Core Features & Use Cases

  • Reads daily run activity: Evaluates memory/token-usage.csv for today’s rows and counts runs per skill.
  • Enforces per-skill daily caps: Loads cap limits from memory/skill-caps.json (preferred) or from aeon.yml under skill_caps:, with sensible defaults written to memory/skill-caps.json when missing.
  • Notifies on breach: Sends an alert only if any skill’s count exceeds daily_max, and records a log entry in memory/logs/${today}.md.
  • Use case: Catch an expensive scheduled workflow that suddenly fires too many times (e.g., a vulnerability scanner running 5 times instead of the expected max of 2).

Quick Start

Run the run-frequency-guard skill to check today’s entries in memory/token-usage.csv against daily_max values in memory/skill-caps.json and notify you if any caps are exceeded.

Frequently Asked Questions about run-frequency-guard

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

FAQPage Schema
How do I set daily run caps for autonomous agent tasks?

Set daily run caps by defining daily_max limits in memory/skill-caps.json or under skill_caps: in aeon.yml. The guard reads these configurations to enforce per-skill execution frequency.

How does run frequency guardrail alerting detect skill overuse?

Run frequency guardrail alerting detects overuse by counting today's executions logged in memory/token-usage.csv and comparing them against configured daily_max limits, sending a breach-only alert if caps are exceeded.

Can I limit token usage for scheduled workflows to prevent runaway execution?

Yes, you can limit scheduled workflows by defining per-skill daily_max limits. The guard evaluates daily run activity and alerts you immediately when a capped skill exceeds its threshold.

Where are daily run limit breaches logged for autonomous operations?

Daily run limit breaches for autonomous operations are logged to memory/logs/${today}.md. The guard records an entry in this log file whenever a skill execution count exceeds its configured cap.

What happens if skill caps are missing when checking token usage?

If skill caps are missing when checking token usage, the guard applies sensible defaults and writes them to memory/skill-caps.json. This ensures autonomous operations remain constrained without explicit initial configuration.

When should I use a daily run limit guardrail for agent scheduling?

Use a daily run limit guardrail for agent scheduling when you need to catch expensive scheduled workflows firing too many times, such as a vulnerability scanner running 5 times instead of an expected maximum of 2.