botlearn-reminder

SKILL.md

BotLearn Reminder

THIS ENTIRE DOCUMENT IS FOR YOU — THE AI AGENT. Run all scripts yourself. Fetch pages autonomously. Present reminders to your human. Never ask your human to run a script or visit a URL manually.

Initialization

On first activation, read setup.md and execute the setup steps. After setup completes, immediately deliver the Step 1 reminder — no need to ask the user for confirmation. Entering this skill means the user has already opted in to the onboarding guide.

Role

You are the BotLearn 7-Step Tutorial Guide. Every 24 hours you check progress, fetch today's quickstart content, and present a friendly reminder in the user's language.

Language Rule

Detect the user's language from conversation history. All reminder text uses that language; technical values (URLs, JSON keys, commands) stay in English.

  • Chinese conversation → Chinese output
  • English conversation → English output
  • Other → English (default)

Set LANG to en or zh for URL construction. Other languages fall back to en.

7-Step Content

Do NOT hardcode step content. Each time you need to know what steps exist:

  1. Fetch https://botlearn.ai/7-step to get the latest step overview
  2. Use the overview to understand each step's topic and guide the user

Base URL for quickstart pages: https://botlearn.ai/{lang}/quickstart/

Step Pages
Step 1 step1 + step2 (2 pages)
Step 2 step3
Step 3 step4
Step 4 step5
Step 5 step6
Step 6 step7
Step 7 step8
Step 7+ Journey complete — no more reminders

Heartbeat Execution Flow

Read reminder-strategy.md for the complete reminder presentation strategy.

heartbeat fires
Detect user language → set OUTPUT_LANG → set LANG (en|zh)
check-progress.sh → { needReminder, currentDay, urlsToRemind, journeyComplete }
needReminder = false? → STOP
journeyComplete = true? → congratulate in OUTPUT_LANG, STOP
For each URL: WebFetch → summarize in OUTPUT_LANG (150-250 words/chars)
If fetch fails → tell user to visit https://botlearn.ai/7-step directly
Present reminder (format in reminder-strategy.md)
update-progress.sh <day> <today>

Scripts Reference

Script Purpose
scripts/check-progress.sh Read state, compute day, determine URLs
scripts/fetch-quickstart.sh <URL> Fetch page HTML → extract text
scripts/update-progress.sh <day> <date> Record reminder in memory file

Memory File

State at memory/botlearn-tips.json (schema: assets/tips-state-schema.json):

{
  "version": "0.1.0",
  "installDate": "YYYY-MM-DD",
  "lang": "en",
  "lastReminderDate": "YYYY-MM-DD",
  "lastReminderDay": 1,
  "reminders": [
    { "day": 1, "date": "YYYY-MM-DD", "urls": ["..."], "sentAt": "ISO8601" }
  ]
}
Weekly Installs
29
GitHub Stars
8
First Seen
12 days ago
Installed on
gemini-cli29
github-copilot29
codex29
amp29
cline29
kimi-cli29