run-frequency-guard

Detect daily per-skill run limit breaches from memory/token-usage.csv and notify when exceeded.

Updated Jun 2, 2026
One-click install
npx skills add https://github.com/Atrium-Hermes/atrium-lighthouse --skill run-frequency-guard-atrium-hermes
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: run-frequency-guard
Source: https://github.com/Atrium-Hermes/atrium-lighthouse/tree/main/skills/run-frequency-guard
Command: npx skills add https://github.com/Atrium-Hermes/atrium-lighthouse --skill run-frequency-guard-atrium-hermes

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The tool monitors per-skill daily run counts and raises alerts when any skill exceeds its configured daily limit.

Core Features & Use Cases

  • Daily run cap monitoring: Tracks runs per skill from memory/token-usage.csv.
  • Breach detection: Compares counts against memory/skill-caps.json or aeon.yml caps and identifies breaches.
  • Notifications & logging: Creates a pending notification and logs outcomes to memory/logs on breach or OK.
  • Auto cap management: Updates or creates memory/skill-caps.json if missing.

Quick Start

Run the frequency guard to check today's runs and trigger a notification if any cap is breached.

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 run limits for individual skills?

To monitor daily run limits, this skill reads memory/token-usage.csv to determine today's counts and compares them against configured caps to identify any breaches.

How do I get notifications when a skill exceeds its daily run cap?

You can get notifications by running the frequency guard, which creates a pending notification and logs outcomes to memory/logs whenever a daily run cap is breached.

Where does the skill read daily run counts and store configured caps?

The skill reads daily run counts from memory/token-usage.csv and stores or updates the configured limits in memory/skill-caps.json, or alternatively uses aeon.yml caps.

Do I need to manually create the skill-caps.json file before monitoring run limits?

No, you do not need to manually create it, as the skill features auto cap management that updates or creates memory/skill-caps.json automatically if the file is missing.

What happens when a daily per-skill run limit is breached?

When a daily per-skill run limit is breached, the tool detects the breach, stores the report, updates caps as needed, and triggers a notification alerting you of the exceeded limits.