Usage

The three shapes a question can take, and what you can ask Learner for directly.

The three question styles

code

What a specific changed function does.

architecture (alias archi)

Which module, directory or layer the code lives in, and why that is where it belongs.

fill

The interactive exercise above: holes cut in the real file, filled in by you.

questionStyles takes either "auto", the default, or a subset of those three. "auto" varies the format from one question to the next, picking whichever fits what changed. Naming a subset restricts it — set it to ["code"] and no exercise will ever touch a file; set it to ["fill"] if writing code back is the only feedback you trust.

There is no setting for the language of the questions. Claude mirrors whatever you are writing in the conversation.

On demand

Everything above happens on its own, once per turn. The same learner skill also answers when you ask it directly — invoke it as learner <subcommand>:

learner quiz [base-ref] [count]

Q&A over the current branch diff, right now, instead of waiting for the Stop hook — optionally against a named base ref, for a chosen number of questions.

learner status

Read-only: your level, plus what to improve — the record the lede above promises, read back to you on request. No quiz, no write.

learner improve [topic]

Coaches one weak spot — named, or the most open one on record — to mastery.

learner export [notion-page-url]

Pushes the recap into a Notion database — one row per competency theme, with a learning level derived from your session history. Needs the Notion connector; the parent page URL is asked for once, on the first export, and remembered after that.

learner update

Checks the remote version and, if it is newer, re-runs the installer pinned to it. Safe to run any time — a no-op when you are already current.

learner config [key=value …]

Views or edits settings. learner config project … scopes the edit to the current repository instead of the global default; with no arguments it prints your current settings.

learner off / learner on

Silences or restores the automatic quiz in the current repository. See Turning it off for what that writes and why.

learner help

Prints its subcommand and parameter reference, then stops.

Next: Configuration — every setting Learner reads.