Skilark — Telegram Bot

Quick Start

Open https://t.me/MySkilarkBot → tap Start → pick topics → pick schedule → get first challenge. That's it.

Getting Started

When you open the bot for the first time, onboarding walks you through three steps:

Tap Let's go to create a new account, or I have an existing account to link an existing CLI account.
Pick your topics from a 2-column keyboard — tap to toggle, checkmarks show what's selected.
Choose your daily schedule: Morning (9am), Lunch (12pm), or Evening (7pm) — times are UTC.

Your first challenge is sent immediately after setup completes.

Commands

`/start`

Begin onboarding or re-enter setup to change your schedule. Safe to run at any time — existing progress is preserved.

`/status`

View your streak, weekly count, all-time completions, and top topics.

`/topics`

Update your topic preferences using the same toggle keyboard from onboarding. Changes take effect on your next challenge.

`/more`

Get another challenge right now without waiting for the daily push. Useful if you want extra practice or missed a day.

`/signals`

Top 5 market signals for the week — company hiring surges and salary outliers. Use /signals all for the full list.

`/fit <keywords>`

Semantic job search against current listings. Example:

/fit senior backend engineer Python

Or send a PDF resume directly (no command needed) for skill gap analysis. Max 5MB.

`/link`

Generate a 6-character code to link your Telegram and CLI accounts. See Account Linking below.

Answering Challenges

Just type your answer as a plain text message — no command prefix needed. The bot replies with whether you're correct and an explanation of the answer.

If you answer incorrectly, you get two self-assessment buttons:

Yeah, I knew that — marks as correct via self-correction
Nope, learned something new — records it as a learning moment

Resume Upload

Send any PDF file directly to the bot — no command needed. The bot extracts your profile, searches for matching roles in current listings, and identifies skill gaps. Maximum file size is 5MB.

Daily Schedule

Challenges arrive automatically at your chosen time. To change your schedule, run /start again and select a new time slot. Schedule times are UTC — see Limitations below.

Account Linking

Your progress syncs across CLI and Telegram once accounts are linked. Linking is bidirectional — start from either side:

Telegram to CLI: Run /link in the bot to get a 6-character code, then run the following in your terminal:
```
skilark link CODE
```
CLI to Telegram: Run the following in your terminal to get a code:
```
skilark link
```
Then paste it when the bot asks during /start → "I have an existing account".

Limitations

Schedule times are UTC — timezone detection is not yet available.
There is no /help command. Use this page or the BotFather command menu for command discovery.

Coming Next

Timezone support for scheduling
Personalized gap-based challenge selection
Inline skill gap analysis with market context