KeepLearn / Docs

Setup and use

Start here if you haven't installed a skill before.

What KeepLearn does

KeepLearn is a skill: a set of instructions and tools that adds a specific ability to an AI coding agent. It helps your agent turn readable resources into a personal course.

Your agent plans the course, writes lessons, and discusses your answers. Your browser is where you read and practice. The browser page is not an AI chat.

You don't need to write lesson code yourself. You do need an agent that can read and write files and run local commands. You'll also need to install a few tools.

Before you install

A coding agent that supports skills. The installer offers a choice of agents. Your agent may need its own account or subscription. Not every agent and browser combination has been tested.
Node.js (LTS). This includes npm, which runs the skill installer.
Python 3.10 or newer. This runs the local server that opens your lessons and saves activity.

Check whether the tools are installed

Open Terminal on macOS/Linux, or PowerShell on Windows. A terminal is an app for running text commands. Run these commands one at a time:

node --version
npm --version
python3 --version

On Windows, try py --version if python3 isn't available. If a command isn't found, install that tool and reopen your terminal.

Install the skill

Create a new folder for your course and open it in your agent. Open a terminal in that folder and run:

npx skills add Nissorn/keeplearn --skill keeplearn

Follow the installer's prompts to choose your agent. Reload skills or start a new agent session if KeepLearn doesn't appear.

Inspect available skills without installing

npx skills add Nissorn/keeplearn --list

Install manually

Download the repository from GitHub. Place the keeplearn folder in the skill directory documented by your agent. Check for an existing copy before replacing anything, then reload skills. Keep course folders separate from the installed skill.

Your first lesson

Open your course folder in the agent. Send this prompt, replacing the text in brackets:

Use keeplearn to help me learn [topic] from [resource link or document]. My goal is [what I want to be able to do]. My background is [what I already know]. I prefer English. Please guide me through setup and open my first lesson.

The agent checks that it can read your source, asks about any missing goals, and plans the course. If a link isn't accessible, provide a transcript or document. Lessons are created as you need them.

Ask the agent to start the local lesson server. Open the exact address it prints, including 127.0.0.1 and the port number. Keep the server running while you learn. This address only works on your own computer.

Choose a course language

Choose English or Thai when you start. New lessons use only that language. A later change affects future lessons; ask explicitly to translate an existing lesson. This website's EN / ไทย button only changes this website, not your course.

Read and practice

Step-by-step mode pairs explanations with visuals. Whole-lesson mode lets you read continuously. Switching views keeps your answers and experiment state. Use Contents to jump to a section.

Discuss open-ended answers with your agent. The local page doesn't grade them with AI. Your agent creates topic-specific experiments when useful; not every lesson needs a simulation.

Continue a course

Open the same course folder in your agent and ask: "Use keeplearn to help me continue." It can use your saved progress and learning notes to choose what to work on next.

Keep each course in its own folder. A history of completed pages or saved answers isn't proof of understanding.

Troubleshooting

The agent can't find KeepLearn

Reload skills or start a new session. Check that you installed for the agent and workspace you're using. Ask the agent to use keeplearn by name, or select it in the agent's skill picker. Slash-command syntax depends on the agent.

The lesson page won't open

Ask your agent to check that Python is available, the lesson has been generated, and the local server is running. Use its exact printed address. If a port is occupied, ask for another port rather than stopping an unrelated process. Don't expose the server publicly.

The runtime guide has technical checks and commands.

The agent can't read a video or link

Provide a transcript or readable document. The agent should not invent a source's contents from its title or silently replace it with another source.

The Copy button doesn't work

Your browser may block clipboard access. Select the command and copy it manually using Ctrl+C or ⌘C, or your device's Copy menu. Paste it into your terminal.

Privacy and limitations

The bundled server saves course data in your course folder, has no telemetry, and listens only on your own computer. Your coding agent and the third-party installer have their own data policies.

Keep credentials out of course folders. Don't run lesson code you don't trust or publish the local server online. Back up a course before rewriting or migrating it.

This is an early version. AI-created explanations and experiments still need checking against trustworthy sources. The bundled server needs no model API key or hosted account, but your coding agent has its own requirements and costs.

Source and license

The source is public, but no open-source license has been selected yet. Public availability doesn't grant general permission to modify or redistribute the work. Check the repository for current terms.

KeepLearn is inspired by Matt Pocock's /teach workflow. It is not affiliated with or endorsed by Matt Pocock.

Technical documentation ↗