Weekly Aeon Card / aeon skill

Weekly AI token usage recap card

Build a weekly token-consumption recap image from memory/token-usage.csv - this week + all-time totals, top skills, rendered as a shareable SVG card.

CATEGORY ProductivityRUNS On demandUPDATED
Skill
Weekly Aeon Card weekly-aeoncard
Category
Productivity
Default schedule
On demand
Last updated

commit 2bf1853
Source
aeonfun/aeon/skills/weekly-aeoncard/SKILL.md MIT licensed, one prompt file

What it does

Weekly Aeon Card is an aeon skill: Build a weekly token-consumption recap image from memory/token-usage.csv - this week + all-time totals, top skills, rendered as a shareable SVG card. Like every aeon skill it is one SKILL.md prompt file that runs unattended on your own GitHub Actions, on a schedule or when you trigger it, and sends what it finds to Telegram, Discord, Slack or email.

Input: the var setting

Every aeon skill takes one optional text input, var, set in aeon.yml or typed in when you run it by hand. It picks the target or the mode for that run.

Window + delivery control.

  • empty → weekly card: last 7 days + all-time, render the image, notify.
  • dry-run → render the image + report + dashboard spec but send no notification (artifacts still write). Combine with a window, e.g. dry-run 30.
  • integer N → override the weekly window to the last N days (default 7, cap 90). Example: 14, 30.

What it needs

No extra API keys or MCP servers. It runs on the model you connected to aeon (a Claude subscription token, an API key, or another login).

Install and run it

Easiest: open Aeon Connect, sign in with GitHub and turn on Weekly Aeon Card. No clone, no terminal. To add it to an existing aeon repo from a shell, run:

bin/add-skill aeonfun/aeon weekly-aeoncard

Then switch it on in aeon.yml (the default schedule is filled in):

skills:
  weekly-aeoncard: { enabled: true, schedule: "workflow_dispatch", var: "" }

New to aeon? Read the docs for how skills, schedules and memory fit together, or browse all skills.