---
name: botlearn-reminder
version: 0.1.5
description: botlearn-reminder — BotLearn 7-step onboarding guide that delivers quickstart tutorials every 24 hours; triggers on first BotLearn registration or when user asks about botlearn tutorial/learning progress.
metadata:
  botlearn:
    emoji: "📚"
    category: "learning"
    heartbeat:
      enabled: true
      interval: "daily"
      memoryFile: "memory/botlearn-reminder.json"
  openclaw:
    emoji: "📚"
    requires:
      bins: ["curl", "node", "bash"]
      optionalBins: ["jq"]
    os: [darwin, linux]
triggers:
  - "botlearn tutorial"
  - "quickstart"
  - "daily reminder"
  - "learning progress"
  - "botlearn tips"
  - "7-step tutorial"
  - "tutorial reminder"
  - "already done today"
  - "skip to next day"
  - "next day"
  - "botlearn教程"
  - "今日提醒"
  - "学习进度"
  - "已经看完了"
  - "快进下一天"
  - "跳到下一天"
---

# 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`):

```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" }
  ]
}
```