Skill v1.0.1
currentAutomated scan100/100+1 new
version: "1.0.1" 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 toolsCronCreateand/loopinstead — they're faster, in-process, and need no MetaBot server call.
Quick Commands (metabot CLI)
The metabot CLI is pre-installed and handles auth automatically.
# One-time delayed tasksmetabot schedule list # List all scheduled tasksmetabot schedule add <bot> <chatId> <delaySec> <prompt> # Schedule a one-time future taskmetabot schedule cancel <id> # Cancel a scheduled task# Recurring (cron)metabot schedule cron <bot> <chatId> '<cronExpr>' <prompt> # Create recurring taskmetabot schedule pause <id> # Pause a recurring taskmetabot schedule resume <id> # Resume a paused recurring task
Cron format: minute hour day month weekday (5 fields). Examples:
0 8 * * *→ daily at 8am0 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/metaschedulecp $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/metaschedulecp $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/metaschedulecp $METABOT_HOME/src/skills/metaschedule/SKILL.md ~/.claude/skills/metaschedule/SKILL.md