agentleFS
botlearn-aibotlearn-ai/botlearn-skills/skills/botlearn-reminder/SKILL.md

botlearn-reminder

Skill9 starsChanged 8 months agoMITView on GitHub

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.

We split this skill into the rules it gives an agent

3 rules. About 0 are common, 2 are distinctive, and 1 is very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈2

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 1

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    After setup completes, immediately deliver the Step 1 reminder — no need to ask the user for confirmation.

    line 47
  2. Distinctive:

    Use the overview to understand each step's topic and guide the user

    line 68
  3. Very specific:

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

    line 85

≈ “Common” is an estimate: at least 1 in 5 of the 308,232 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
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/

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

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

Reviews can't be read right now.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.