metaschedule - SKILL.md Agent Skill

name: metaschedule description: "MetaBot's persistent server-side scheduler (cron + one-shot). Optional skill — not installed by default. Use when the user wants tasks that survive Claude session restarts, are visible to other bots, or need to run in MetaBot's PM2 process rather than this Claude session."

MetaBot Scheduler

Persistent server-side scheduler. Use this when:

The schedule needs to outlive the current Claude session.

Another bot or operator may need to list, pause, or cancel it.

You want it to run inside MetaBot's PM2 process (not Claude's).

For ad-hoc, session-scoped scheduling, prefer the Claude Code native tools CronCreate and /loop instead — they're faster, in-process, and need no MetaBot server call.

Quick Commands (mb shortcut)

The mb shell function is pre-installed and handles auth automatically.

# One-time delayed tasks
mb schedule list                                       # List all scheduled tasks
mb schedule add <bot> <chatId> <delaySec> <prompt>     # Schedule a one-time future task
mb schedule cancel <id>                                # Cancel a scheduled task

# Recurring (cron)
mb schedule cron <bot> <chatId> '<cronExpr>' <prompt>  # Create recurring task
mb schedule pause <id>                                 # Pause a recurring task
mb schedule resume <id>                                # Resume a paused recurring task

Cron format: minute hour day month weekday (5 fields). Examples:

0 8 * * * → daily at 8am
0 8 * * 1-5 → weekdays at 8am
*/30 * * * *→ every 30 minutes Default timezone: Asia/Shanghai.

API Reference

Auth header: -H "Authorization: Bearer $METABOT_API_SECRET" Base URL: !echo http://localhost:${METABOT_API_PORT:-9100}

Create one-time scheduled task:

curl -s -X POST http://localhost:${METABOT_API_PORT:-9100}/api/schedule \
  -H "Authorization: Bearer $METABOT_API_SECRET" \
  -H "Content-Type: application/json" \
  -d '{"botName":"<bot>","chatId":"<chatId>","prompt":"<task>","delaySeconds":3600,"label":"Reminder"}'

Create recurring task (cron):

curl -s -X POST http://localhost:${METABOT_API_PORT:-9100}/api/schedule \
  -H "Authorization: Bearer $METABOT_API_SECRET" \
  -H "Content-Type: application/json" \
  -d '{"botName":"<bot>","chatId":"<chatId>","prompt":"<task>","cronExpr":"0 8 * * 1-5","timezone":"Asia/Shanghai","label":"Daily report"}'

Update task (prompt, delay, or cron):

curl -s -X PATCH http://localhost:${METABOT_API_PORT:-9100}/api/schedule/<id> \
  -H "Authorization: Bearer $METABOT_API_SECRET" \
  -H "Content-Type: application/json" \
  -d '{"prompt":"updated prompt","delaySeconds":7200}'

curl -s -X PATCH http://localhost:${METABOT_API_PORT:-9100}/api/schedule/<id> \
  -H "Authorization: Bearer $METABOT_API_SECRET" \
  -H "Content-Type: application/json" \
  -d '{"cronExpr":"0 9 * * *","prompt":"Updated prompt","timezone":"Asia/Shanghai"}'

Pause / resume recurring task:

curl -s -X POST http://localhost:${METABOT_API_PORT:-9100}/api/schedule/<id>/pause \
  -H "Authorization: Bearer $METABOT_API_SECRET"
curl -s -X POST http://localhost:${METABOT_API_PORT:-9100}/api/schedule/<id>/resume \
  -H "Authorization: Bearer $METABOT_API_SECRET"

Cancel:

curl -s -X DELETE http://localhost:${METABOT_API_PORT:-9100}/api/schedule/<id> \
  -H "Authorization: Bearer $METABOT_API_SECRET"

Installation (opt-in)

This skill is not installed by default. To enable it for one bot, copy it into the bot's working directory:

mkdir -p <bot-work-dir>/.claude/skills/metaschedule
cp $METABOT_HOME/src/skills/metaschedule/SKILL.md <bot-work-dir>/.claude/skills/metaschedule/SKILL.md
# Mirror for Codex bots:
mkdir -p <bot-work-dir>/.codex/skills/metaschedule
cp $METABOT_HOME/src/skills/metaschedule/SKILL.md <bot-work-dir>/.codex/skills/metaschedule/SKILL.md

Or install globally so every Claude session picks it up:

mkdir -p ~/.claude/skills/metaschedule
cp $METABOT_HOME/src/skills/metaschedule/SKILL.md ~/.claude/skills/metaschedule/SKILL.md