run-frequency-guard

Community

Prevent runaway skill runs with daily caps.

Authoraaronjmars
Version1.0.0
Installs0

System Documentation

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.

Dependency Matrix

Required Modules

None required

Components

Standard package

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: run-frequency-guard
Download link: https://github.com/aaronjmars/aeon/archive/main.zip#run-frequency-guard

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 471,000+ vetted skills library on demand.