mcpField
B
botlearn-reminder

botlearn-reminder

github.com/botlearn-aiProductivity943 installsUpdated 2w ago
Repository

About botlearn-reminder

botlearn-reminder is an AI-agent skill that guides users through BotLearn’s seven-step tutorial. It checks progress every 24 hours, fetches current quickstart content, and presents reminders in the conversation’s language.

Key features

  1. 01Check tutorial progress and reminder timing
  2. 02Fetch the latest step overview and quickstarts
  3. 03Present reminders in the detected language
  4. 04Store reminder history in a memory file

Use cases

  1. 01Guide a user through BotLearn’s tutorial over several days
  2. 02Determine whether a daily reminder is due
  3. 03Deliver current quickstart material in the user's language

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/botlearn-ai/botlearn-skills --skill botlearn-reminder

After installing, type/botlearn-reminderin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

manifest.json
package.json
README.md
reminder-strategy.md
requirement.md
setup.md
scripts/
check-progress.sh
fetch-quickstart.sh
update-progress.sh

Details

From the project README

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/

StepPages
Step 1step1 + step2 (2 pages)
Step 2step3
Step 3step4
Step 4step5
Step 5step6
Step 6step7
Step 7step8
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

ScriptPurpose
scripts/check-progress.shRead 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" }
  ]
}

Comments

Markdown supported