run-frequency-guard

Detects when capped skills exceed their configured daily run limits and sends breach alerts.

Updated May 25, 2026
One-click install
npx skills add https://github.com/Cbowcrptex/CBOWCRYPTEX --skill run-frequency-guard-cbowcrptex
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: run-frequency-guard
Source: https://github.com/Cbowcrptex/CBOWCRYPTEX/tree/main/skills/run-frequency-guard
Command: npx skills add https://github.com/Cbowcrptex/CBOWCRYPTEX --skill run-frequency-guard-cbowcrptex

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Automated agent systems can accidentally run expensive or rate-limited skills too many times per day, wasting tokens and compute. This watchdog audits daily run counts against configured caps and alerts operators the moment a limit is breached. ## Core Features & Use Cases - Daily run counting: Parses memory/token-usage.csv and groups today's rows by skill to count executions. - Configurable caps: Reads per-skill daily_max limits from memory/skill-caps.json or an aeon.yml skill_caps: block, seeding sensible defaults if neither exists. - Breach notifications: Writes a formatted alert to a temp file and dispatches it via ./notify -f, then appends a status entry to the daily log. - Use Case: An operator caps an expensive deployment skill at 1 run per day; when a misconfigured schedule fires it twice, the guard detects the breach and sends an immediate notification. ## Quick Start Check whether any capped skills exceeded their daily run limit today and notify me if there are breaches.

Frequently Asked Questions about run-frequency-guard

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

FAQPage Schema
How do I monitor daily skill run counts in an agent system?▼

Track runs in a CSV log with date and skill columns, then group today's rows by skill to count executions. Compare each count against a per-skill daily_max cap and alert when the count exceeds the limit.

How to set daily execution limits for automated skills?▼

Define caps in a JSON file like memory/skill-caps.json mapping each skill name to a daily_max value, or declare them under a skill_caps block in aeon.yml. The JSON file takes precedence when both exist.

What happens if the token usage log file is missing?▼

The guard logs a RUN_FREQ_GUARD_SKIP marker and stops without sending any notification. It treats a missing token-usage.csv or a day with zero rows as a skip condition rather than an error.

Which config wins when both skill-caps.json and aeon.yml exist?▼

The memory/skill-caps.json file wins because operator-edited dynamic state outranks committed configuration. If neither source exists, default caps are written to skill-caps.json and used.

Does the run frequency guard make external network calls?▼

No, it only reads local files including token-usage.csv, skill-caps.json, and aeon.yml. Notifications are dispatched through a local ./notify command, so no external network access is required.