← Back to Skills Marketplace
calvinxhk

botlearn-reminder

by 邢怀康 · GitHub ↗ · v1.0.5
darwinlinux ⚠ suspicious
481
Downloads
1
Stars
8
Active Installs
3
Versions
Install in OpenClaw
/install botlearn-reminder
Description
botlearn-reminder — BotLearn 7-step onboarding guide that delivers quickstart tutorials every 24 hours; triggers on first BotLearn registration or when user...
README (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 \x3Cday> \x3Ctoday>

Scripts Reference

Script Purpose
scripts/check-progress.sh Read state, compute day, determine URLs
scripts/fetch-quickstart.sh \x3CURL> Fetch page HTML → extract text
scripts/update-progress.sh \x3Cday> \x3Cdate> 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" }
  ]
}
Usage Guidance
This skill appears to do what it says (daily reminders fetched from botlearn.ai) and does not request secrets, but review a few things before installing: 1) The skill will create and write a memory file under $OPENCLAW_HOME/memory (default ~/.openclaw/memory) — check/backup that location if needed. 2) On first activation it intends to immediately send Step 1 (auto-opt-in) — if you don't want messages sent without confirmation, don't enable/activate until you inspect the scripts. 3) setup.md asks to append a block to a workspace HEARTBEAT.md (i.e., modify files outside the skill) — make sure you are comfortable allowing that change or perform the registration step manually. 4) There is a small inconsistency in naming the memory file (SKILL.md metadata references memory/botlearn-reminder.json while scripts and manifest use botlearn-tips.json) — this should be clarified to avoid duplicated or misplaced state files. 5) The scripts fetch live content from https://botlearn.ai, use Node for extraction, and run curl; inspect scripts locally to satisfy yourself they perform only the described actions. If you want higher assurance: run the scripts in a sandbox or review/modify them to avoid auto-send and to avoid modifying workspace files without explicit consent.
Capability Analysis
Package: @botlearn/botlearn-reminder (xpi) Version: 0.1.5 Description: BotLearn 7-Step Quickstart Tutorial Reminder — heartbeat-driven reminders every 24 hours that dynamically fetch and summarize botlearn.ai quickstart pages, track progress, and present tips in the user's own language The package is a tutorial reminder tool for the BotLearn platform, designed to run within the OpenClaw agent framework. It tracks a 7-day onboarding process by maintaining a local state file, fetching educational content from the official botlearn.ai website, and presenting summaries to the user. The code consists of shell scripts and Node.js logic that perform transparent state management and content retrieval without any malicious behavior, obfuscation, or unauthorized data exfiltration.
Capability Assessment
Purpose & Capability
Name/description, required binaries (curl, node, bash), and the scripts (fetch, check, update) align with a reminder that fetches and summarizes botlearn.ai quickstart pages. Network access to botlearn.ai is expected and justified.
Instruction Scope
SKILL.md instructs the agent to execute setup steps autonomously and 'immediately deliver the Step 1 reminder' on first activation (effectively auto-opt-in). setup.md asks the agent/user to append a block to a workspace HEARTBEAT.md — this modifies a workspace file outside the skill's own directory. There's also a small contradiction: setup.md suggests a manual initial run while SKILL.md says 'Never ask your human to run a script', creating ambiguity about who should perform setup actions. These are scope/behavior concerns (auto-sending messages and writing to arbitrary workspace files).
Install Mechanism
No install spec (instruction-only + shipped scripts) — lowest install risk. The included scripts are plain bash+Node and are not downloaded from arbitrary URLs during install.
Credentials
No secrets or credentials requested. The skill uses OPENCLAW_HOME (non-secret) for memory storage; manifest lists primaryEnv: OPENCLAW_HOME while registry metadata shows no required env vars — minor inconsistency but not a secret. Optional BOTLEARN_LANG can influence which botlearn.ai locale is fetched.
Persistence & Privilege
always: false (no forced global presence). The skill writes state to the agent memory directory (~/.openclaw/memory by default), which is normal. However, setup.md's instruction to append to a workspace HEARTBEAT.md means it will modify another file in the user's workspace — this is a privilege/side-effect the user should expect and explicitly allow.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install botlearn-reminder
  3. After installation, invoke the skill by name or use /botlearn-reminder
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.5
botlearn-reminder 1.0.5 - Onboarding flow revised: users now receive the Step 1 reminder immediately after setup, with no extra confirmation needed. - All step content and topics are now dynamically fetched from https://botlearn.ai/7-step; step details are no longer hardcoded. - New reminder flow and formatting strategies are documented in README.md and reminder-strategy.md. - Content fallback now instructs the user to visit https://botlearn.ai/7-step directly if page fetch fails; old fallback files removed. - Asset and test files cleaned up for clarity and maintenance.
v1.0.4
- Updated tutorial URL structure to use "step1" through "step8" (instead of "day0" through "day7") - Base tutorial URL now uses `{lang}` placeholder for dynamic language support; falls back to English if not supported - Added explicit language code handling in memory schema and reminder generation - Memory schema updated to include `"lang"` field and to use new URL pattern - Small adjustments to description and initialization to match new structure and language handling
v1.0.0
- Initial release of BotLearn Reminder with daily heartbeat-driven 7-day tutorial guidance - Auto-detects user’s conversation language and delivers reminders in the same language - Fetches and summarizes live quickstart content for each day; provides a fallback if offline - Tracks user progress and prevents duplicate or obsolete reminders; stops after Day 7 - Easily integrates on macOS and Linux, requiring bash, node, curl (jq optional)
Metadata
Slug botlearn-reminder
Version 1.0.5
License
All-time Installs 8
Active Installs 8
Total Versions 3
Frequently Asked Questions

What is botlearn-reminder?

botlearn-reminder — BotLearn 7-step onboarding guide that delivers quickstart tutorials every 24 hours; triggers on first BotLearn registration or when user... It is an AI Agent Skill for Claude Code / OpenClaw, with 481 downloads so far.

How do I install botlearn-reminder?

Run "/install botlearn-reminder" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is botlearn-reminder free?

Yes, botlearn-reminder is completely free (open-source). You can download, install and use it at no cost.

Which platforms does botlearn-reminder support?

botlearn-reminder is cross-platform and runs anywhere OpenClaw / Claude Code is available (darwin, linux).

Who created botlearn-reminder?

It is built and maintained by 邢怀康 (@calvinxhk); the current version is v1.0.5.

💬 Comments