Get started with Aeon
Aeon is an agent that runs skills on a schedule with GitHub Actions in the user's own GitHub repo. This plugin connects to their Aeon agent through Aeon Connect (https://www.aeon.fun/connect/mcp).
1. Check the connection
Call list_skills.
- It works: go to step 2.
- It asks to sign in, or fails with an auth error: tell the user to connect Aeon (sign in with GitHub, then pick their agent on the "Connect an app" screen), then try again.
- They have no agent yet: send them to https://www.aeon.fun/connect to create one (about two minutes: sign in with GitHub, create the repo, connect a model). Then connect the plugin again.
The connection works on one agent repo at a time. If the user allowed switching when they connected, list_instances shows their other Aeon repos and switch_instance moves to one. Only bring this up if they have more than one agent or ask about another repo.
2. Show what the agent does and what it still needs
From the list_skills result, tell the user in a few lines:
- which repo the plugin is connected to,
- how many skills are on, and the schedule of each one that is on,
- two or three skills that are off and look useful, with one line each.
Keep it short. Do not list every skill.
Then call setup_status. If a model is not connected, or enabled skills are missing API keys, name what is missing and say where to add it: the Keys tab for this agent at https://www.aeon.fun/connect. setup_status gives key names only. Never ask for the values.
3. Run one skill
If a model is connected, offer to run heartbeat (a quick check that the agent works; it needs no setup). If the user agrees:
- Call
run_skill with skill: "heartbeat".
- Follow the run. Some apps show a live runs view right in the chat; otherwise call
get_run with the returned run_id every so often until status is completed. A run takes one to ten minutes; tell the user it is running and keep the chat useful meanwhile.
- If it succeeded, call
read_output with skill: "heartbeat" and summarize what it found in a few lines.
- If it failed,
get_run gives the likely reason (most often the model login is missing or expired). Explain it and the fix in plain words, and point to https://www.aeon.fun/connect to fix it.
If there is no heartbeat skill, offer any skill that is on instead. If no model is connected, skip this step and point back to the missing model from step 2.
4. Next steps
Tell the user what they can ask from now on, for example:
- "Turn on the digest skill every morning at 8"
- "Did anything fail today? Why?"
- "Show me what my last digest found"
- "What has my agent written down about this week?"
- "Add 'grow the newsletter' to my strategy"
- "What skill packs can I add?"
- "Open my Aeon dashboard"
Rules
update_skill, update_strategy, update_soul, install_pack (it opens a pull request), switch_instance, update_instance_settings and the settings switches change the user's setup. Say what will change and get a yes before calling them.
- Never ask for API keys, tokens or secrets.
setup_status shows key names only; keys are added in Aeon Connect, not in chat.
- If an Aeon tool fails or answers wrong,
send_feedback reports it to the Aeon team (pass run_id for a failed run). Tell the user what you sent; never include secrets.
1---2name: get-started3description: First-run setup for the Aeon plugin. Checks the connection to the user's Aeon agent, shows what it can do, and runs one skill so the user sees it work. Use right after the plugin is installed, or when the user asks how to get started with Aeon.4metadata:5 source: https://skillmd.com/skills/aaronjmars/get-started6---78# Get started with Aeon910Aeon is an agent that runs skills on a schedule with GitHub Actions in the user's own GitHub repo. This plugin connects to their Aeon agent through Aeon Connect (`https://www.aeon.fun/connect/mcp`).1112## 1. Check the connection1314Call `list_skills`.1516- **It works:** go to step 2.17- **It asks to sign in, or fails with an auth error:** tell the user to connect Aeon (sign in with GitHub, then pick their agent on the "Connect an app" screen), then try again.18- **They have no agent yet:** send them to https://www.aeon.fun/connect to create one (about two minutes: sign in with GitHub, create the repo, connect a model). Then connect the plugin again.1920The connection works on one agent repo at a time. If the user allowed switching when they connected, `list_instances` shows their other Aeon repos and `switch_instance` moves to one. Only bring this up if they have more than one agent or ask about another repo.2122## 2. Show what the agent does and what it still needs2324From the `list_skills` result, tell the user in a few lines:2526- which repo the plugin is connected to,27- how many skills are on, and the schedule of each one that is on,28- two or three skills that are off and look useful, with one line each.2930Keep it short. Do not list every skill.3132Then call `setup_status`. If a model is not connected, or enabled skills are missing API keys, name what is missing and say where to add it: the Keys tab for this agent at https://www.aeon.fun/connect. `setup_status` gives key names only. Never ask for the values.3334## 3. Run one skill3536If a model is connected, offer to run `heartbeat` (a quick check that the agent works; it needs no setup). If the user agrees:37381. Call `run_skill` with `skill: "heartbeat"`.392. Follow the run. Some apps show a live runs view right in the chat; otherwise call `get_run` with the returned `run_id` every so often until `status` is `completed`. A run takes one to ten minutes; tell the user it is running and keep the chat useful meanwhile.403. If it succeeded, call `read_output` with `skill: "heartbeat"` and summarize what it found in a few lines.414. If it failed, `get_run` gives the likely reason (most often the model login is missing or expired). Explain it and the fix in plain words, and point to https://www.aeon.fun/connect to fix it.4243If there is no `heartbeat` skill, offer any skill that is on instead. If no model is connected, skip this step and point back to the missing model from step 2.4445## 4. Next steps4647Tell the user what they can ask from now on, for example:4849- "Turn on the digest skill every morning at 8"50- "Did anything fail today? Why?"51- "Show me what my last digest found"52- "What has my agent written down about this week?"53- "Add 'grow the newsletter' to my strategy"54- "What skill packs can I add?"55- "Open my Aeon dashboard"5657## Rules5859- `update_skill`, `update_strategy`, `update_soul`, `install_pack` (it opens a pull request), `switch_instance`, `update_instance_settings` and the settings switches change the user's setup. Say what will change and get a yes before calling them.60- Never ask for API keys, tokens or secrets. `setup_status` shows key names only; keys are added in Aeon Connect, not in chat.61- If an Aeon tool fails or answers wrong, `send_feedback` reports it to the Aeon team (pass `run_id` for a failed run). Tell the user what you sent; never include secrets.