aeon

aeon is a skill for Claude Code, Codex from aaronjmars/aeon-agent. It costs 147 tokens per session (8,358 once invoked), scanned A, a copy of aeon, MIT.

A setup and management skill for Aeon, an agent that runs scheduled work in your own GitHub repository through GitHub Actions. It helps create an instance, configure skills, change schedules, and turn repeated chat work into scheduled tasks.

In plain words
What is it for?
Use it to install or select skills, reschedule runs, fix skills that do not trigger, edit existing skills, or define Aeon's strategy and voice.
Why use it?
It gives you a structured way to start, adjust, or repair an Aeon instance instead of editing its files without guidance. It also helps keep the agent's purpose and writing style defined.

Skill for Claude CodeCodex

Written for no agent in particular: nothing here depends on one. Also seen: reads .claude/ paths; mentions CLAUDE.md; mentions subagents.

Needs its repository: it runs a file that does not travel with it, so clone the repository first. The line is bash scripts/check-skill-categories.sh # category is one of the six.

Good fit Use it to install or select skills, reschedule runs, fix skills that do not trigger, edit existing skills, or define Aeon's strategy and voice.

Compare 6 skills from other repositories ↓
Install

Getting it into your agent

It runs from inside its repository, so the clone comes first — what it calls does not travel with the file alone.

Clone the repo
git clone --depth 1 https://github.com/aaronjmars/aeon-agent
agentmods
npx agentmods add skills/aaronjmars/aeon-agent/claude__skills__aeon_

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for aeon

README.md
[![agentmods](https://agentmods.dev/badge/skills/aaronjmars/aeon-agent/claude__skills__aeon_/github.svg)](https://agentmods.dev/skills/aaronjmars/aeon-agent/claude__skills__aeon_)
Your own site
<a href="https://agentmods.dev/skills/aaronjmars/aeon-agent/claude__skills__aeon_"><img src="https://agentmods.dev/badge/skills/aaronjmars/aeon-agent/claude__skills__aeon_/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for aeon

Your own site · 80×15
<a href="https://agentmods.dev/skills/aaronjmars/aeon-agent/claude__skills__aeon_"><img src="https://agentmods.dev/badge/skills/aaronjmars/aeon-agent/claude__skills__aeon_.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 147 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 8,358 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 1 finding. A grade says what 26 rules found in the file — not that it is safe. ✓ AI security review Sonnet 5 · 7 Sept 2026 📄 Read the review
Origin 98% copy Near-identical to another mod in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00147 $0.08358
Opus 5 $0.00073 $0.04179
Sonnet 5 $0.00029 $0.01672
Haiku 4.5 $0.00015 $0.00836

Measured 6d ago against content hash ee643687f351, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-11, from the pricing page.

Security

Grade A, and why

aeon scanned grade A with 1 finding against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 6d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Makes network callslowCapability

Not a fault in itself. Listed so you know the mod talks to something, and to what.

<curl / WebFetch / `./secretcurl` / `gh api` — how this skill fetches>
Origin

This is a copy

98% identical to aeon — 6 lines differ, which has more behind it and is treated as the original. This page carries a canonical link to it rather than competing with it.

output/.tmp-aeon-update/head/.claude__skills__aeon__SKILL.md · 452 lines

How it starts

The opening of the file, as written. The whole thing — 452 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Aeon

Aeon is an agent that runs on the user's own GitHub repo via Actions. A skill is a Markdown file (skills/<name>/SKILL.md); aeon.yml says which ones run and when.

Pick the mode they're asking for:

1 · Start No instance yet, or set one up from scratch
2 · Reschedule Change times, cadence, or what a skill focuses on
3 · Unblock "It didn't run" / "nothing happened"
4 · Chat → skill Turn what we just did into a scheduled skill
5 · Edit a skill Change what an existing skill does
6 · What to turn on Pick skills, browse packs, install more
7 · Strategy & voice STRATEGY.md and soul/ — the north star and the tone
8 · Mine history → skill "What of my repeated work could Aeon do for me?" — surface it from past Claude Code chats

Preflight (every mode)

  1. Find the repo: current dir → gh repo set-default → ask. Clone it if it isn't local.

  2. Confirm gh points at THEIR instance, before any command that writes.

    gh repo view --json nameWithOwner -q .nameWithOwner
    

    If that prints aeonfun/aeon and they aren't working on upstream itself, stop and run gh repo set-default <owner>/<repo>. gh prefers an upstream remote over origin when no default is pinned, and every Aeon write (auth, secrets set, skills run, config pushes) is a gh -R <resolved> call — so it will cheerfully put their API keys on the upstream repo and dispatch runs there. It looks like success: no error, a real run id, and the skill just never fires on their instance.

  3. gh auth status — everything routes through gh. If it fails, tell them to run gh auth login and stop.

  4. Use the ./aeon CLI for all config writes. It preserves comments in aeon.yml and validates. Never hand-edit the YAML — with one exception: the CLI cannot create an entry for a brand-new skill (see Mode 4 step 4).

Don't trust "disabled" for a skill you just created. The read path lists skills from disk and defaults a missing aeon.yml entry to enabled: false, so "not configured" and "disabled" look identical. One command tells them apart:

Read the full file on GitHub · 452 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 6d ago First seen · 452 lines · 147 tokens per session scan E ee643687f351

Subscribe to this mod's changes

aeon is a skill published in the GitHub repository aaronjmars/aeon-agent (11 stars, last pushed today), licensed MIT. It adds 147 tokens to every session and 8,358 once invoked, about $0.0007 per session on Opus 5. A static security scan graded it A with 1 finding (makes network calls). It is 98% identical to aeon, differing in 6 lines, and is treated as a copy.

Related

Other skills, from other repositories

import-prom-rule

Bulk import of a Prometheus alert rule YAML file (create a whole set of rules at once). Dedicated to handling a remote URL or local YAML text, automatically parsing the three formats groups / a plain rules array / a single rule. ⚠️ Do not use this skill for single-rule creation — when the user describes a single alert…

ccfos/nightingale · 125 tokens

chinese-git-workflow

A reference for configuring Git with Chinese code-hosting services such as Gitee, Coding.net, GitLab China, and CNB, including SSH, HTTPS, credentials, CI, and repository mirroring.

jnMetaCode/superpowers-zh · 69 tokens

configure-env-variables

Configures environment variables for Power Pages site settings to support ALM across environments. Creates environment variable definitions in Dataverse, guides the user through linking site settings to those variables via the Power Pages Management app, adds the variables to the solution, and generates a…

microsoft/power-platform-skills · 119 tokens

atmos-profiles

Atmos profiles: profile directories, --profile and ATMOSPROFILE activation, profile merge behavior, environment switching, and routing profile-specific auth/toolchain/config overrides.

cloudposse/atmos · 35 tokens

webhook-management

Configure and validate CCAM webhook targets across supported chat, incident, automation, and generic providers. Use when listing provider requirements, creating or updating a target, scoping it to alert rules, sending a test notification, reviewing delivery history, or deleting a target.

hoangsonww/Claude-Code-Agent-Monitor · 56 tokens

managing-github-actions-secrets

Creates and updates GitHub Actions secrets for PostHog workflows. Use when adding a new CI secret, rotating an existing secret, wiring a workflow to an API token, package registry credential, deploy key, or any value referenced via ${{ secrets. }} in .github/workflows/.

PostHog/posthog-foss · 67 tokens