Learning Check-in Skill

Help users build a daily learning habit through simple check-ins and intelligent reminders.

Overview

This skill enables users to track their daily learning with:

• - Simple daily check-in (just say "I'm done" or "check-in complete")
• Automatic streak tracking
• Optional smart reminders

Data Storage

All data is stored locally in a data subfolder next to the skill:

CODEBLOCK0

The data folder is automatically created on first use.

Commands

1. Initialize (First Time)

CODEBLOCK1

Returns:

• - welcome_message - Welcome text for the user
• INLINECODE2 - Only contains user_language (for message display)
• INLINECODE4 - Suggested reminder times
• INLINECODE5 - Current reminder configuration status

Agent action:

1. 1. Run the init command
2. Show welcome message and explain the check-in process
3. Ask user if they want daily reminders
4. Ask user to start their first check-in

2. Check-in

CODEBLOCK2

Returns:

• - success - Whether check-in was recorded
• INLINECODE7 - Current streak count
• INLINECODE8 - Celebration message (in English, translate to user's language)

3. Status

CODEBLOCK3

Returns:

• - checked_in_today - Whether user has checked in today
• INLINECODE10 - Current streak count
• INLINECODE11 - Total days checked in
• INLINECODE12 - Status message (in English)

4. Get User Language

CODEBLOCK4

Returns:

• - user_language - Detected language (zh/en)

Why needed: Only to display messages in the user's preferred language.

5. Get Reminder Message

CODEBLOCK5

Where <time> is one of: 09:00, 17:00, INLINECODE17

Returns:

• - message - Reminder text (in English, translate to user's language)

6. Check Reminder Status

CODEBLOCK6

Returns:

• - should_send - Whether reminder should be sent
• INLINECODE20 - Whether user has already checked in today

7. Update Cron Status

CODEBLOCK7

When to use: After setting up reminders (optional).

8. Get Cron Status

CODEBLOCK8

Returns:

• - configured - Whether reminders are set up
• INLINECODE22 - Configured reminder times

Default Behavior

Check-in Rule

• - User checks in once per day
• Simply tell the Agent "I'm done" or "check-in complete"

Reminder Strategy (Suggested)

• - Evening (20:00) is recommended as default
• Or user's preferred time

The skill will check if user already checked in before sending reminders.

Streak System

• - Consecutive days = streak
• Miss a day = streak resets

Customization

Users can edit the rule.md file (in the data folder) to customize reminder messages.

Version

See GitHub releases: https://github.com/daizongyu/learning-checkin/releases

Agent Guidelines

First Interaction (Welcome)

1. 1. Be warm and encouraging
2. Explain the simple check-in process
3. Ask if user wants daily reminders (optional feature)
4. Ask: "Ready to start your first check-in?"

Check-in Interaction

• - Translate messages to user's language
• Celebrate the check-in
• Show streak count

Reminder Implementation (Optional)

• - Agent decides how to implement (cron, native scheduler, etc.)
• The skill provides reminder and message commands
• Check if user already checked in before sending

Technical Notes

• - Data collection: Only user_language is collected for message display
• All messages are in English - Agent translates to user's language
• All file paths use UTF-8 encoding
• Compatible with Windows, Linux, macOS
• Data stored in data subfolder next to the skill
• No external network requests from the skill
• No automatic scheduling - Agent decides implementation
• No external dependencies (Python standard library only)

Version

Current version: 3.1.0

GitHub: https://github.com/daizongyu/learning-checkin