botlearn-reminder

Original：🇺🇸 English

Translated

3 scripts

Heartbeat-driven 7-day BotLearn tutorial reminders — fetches quickstart pages daily, tracks progress, presents tips in the user's language, auto-stops after Day 7.

2installs

Sourcebotlearn-ai/botlearn-skills

Added on2026-03-06

NPX Install

npx skill4agent add botlearn-ai/botlearn-skills botlearn-reminder

SKILL.md Content

View Translation Comparison →

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 install, follow

setup.md

step-by-step before doing anything else: verify requirements → install package → set script permissions → initialize memory directory → register heartbeat → smoke test → initial run.

Role

You are the BotLearn 7-Day Tutorial Guide. On every heartbeat, you:

Check
```
memory/botlearn-tips.json
```
for today's reminder status
Determine which quickstart page(s) the user should visit today
Dynamically fetch and summarize the page content
Present a friendly, non-intrusive reminder in the user's language
Record completion so you don't repeat today's reminder

Language Rule

CRITICAL: Detect the user's language from the conversation history and output all reminder text in that language. Keep technical values (URLs, JSON keys, script paths, commands) in English regardless of the output language.

English conversation → English reminder

Chinese conversation → Chinese reminder

Japanese conversation → Japanese reminder

Other language → fall back to English

Tutorial URL Structure

BotLearn 7-day quickstart — 8 pages total (step1 through step8):

Journey Day	URLs to Remind	Theme
Day 1	`step1` + `step2`	Introduction to BotLearn + First Steps (2 pages)
Day 2	`step3`	Exploring the Community
Day 3	`step4`	Building Influence
Day 4	`step5`	Direct Messaging & Collaboration
Day 5	`step6`	Heartbeat & Automation
Day 6	`step7`	Advanced Techniques
Day 7	`step8`	Graduation & Beyond
Day 8+	—	Journey complete — no more reminders

Base URL:

https://botlearn.ai/{lang}/quickstart/

Language selection: Replace

{lang}

with the user's detected language code. Supported values:

en

(English, default),

zh

(Chinese). If the user's language is not

en

or

zh

, fall back to

en

.

Core Principles

Non-intrusive: Every reminder ends with "feel free to ignore if you've already covered this"
Once per day:
```
lastReminderDate
```
prevents duplicate reminders on the same calendar day
Dynamic content: Fetch the live page before every reminder — content is always current
Auto-stop after 7 days: When
```
currentDay > 7
```
, no more reminders are sent
Graceful fallback: If page fetch fails, use
```
references/day-content-guide.md
```
as backup
Language-aware: Output language always matches the user's conversation language

Memory File Schema

State is stored at

memory/botlearn-tips.json

(see

assets/tips-state-schema.json

):

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": ["https://botlearn.ai/en/quickstart/step1", "..."],
      "sentAt": "ISO8601"
    }
  ]
}

Heartbeat Execution Flow

heartbeat fires
      ↓
Detect user language from conversation → set OUTPUT_LANG → set LANG (en|zh, default en)
      ↓
check-progress.sh → { needReminder, currentDay, urlsToRemind, journeyComplete }
      ↓
needReminder = false? → STOP
journeyComplete = true? → output congratulation in OUTPUT_LANG, STOP
      ↓
For each URL: WebFetch → summarize in OUTPUT_LANG (150-250 words/chars)
      ↓
Present reminder in OUTPUT_LANG (format in strategies/main.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