Create your own online course
If you have something to explain and want to build a course rather than a sales page, you can start for free. A course on Skillok is a challenge in a repository: stages in order, each with its own check, and the materials themselves are ordinary files with an edit history.
In this article
What a course is made of#
A course is a folder in a repository with a challenge.md file and stages in
stages/. A stage is an ordinary markdown note: text, plus a check in its
header.
- Theory — LaTeX formulas, tables, diagrams, highlighted code. It counts once the learner marks it as read.
- Questions — single or multiple choice, ordering, pairs, fill in the blanks, a number, a short answer, flashcards. Wrong answers come back at the end of the round, and later into review on a schedule.
- Hands-on tasks — a summary, a calculation, an analysis: the check is that the file exists, has the required sections and the right number.
- Code — tests in Python or JavaScript run in a sandbox.
The next stage opens once the current one is passed. Stages earn experience.
The materials live in a repository#
You write the course as files: every stage has a history, a co-author can
propose an edit as a pull request, and you look at the diff and accept or
decline it. After git clone it opens and edits in Obsidian. You can make a
draft from your own note with the "Make a challenge" button and then edit it
by hand.
Publishing#
A private repository is seen by you and your co-authors. A public one is open to everyone: share a link to the "Learn" tab of your repository. There is no shared course catalogue on the site — you bring your audience yourself.
What is missing#
- payments for a course and paid, gated access;
- video hosting — host videos yourself and link to them from a stage;
- webinars and an interactive whiteboard;
- a results log for a group, and certificates.
Who it suits#
Teachers and specialists who want to build a course for free and try it on the first few people; authors of technical courses who care about formulas, code and automatic checking; people who want to keep their materials in the open, with history.
Where to start#
Write in challenge.md what a learner will be able to do at the end. Build
three stages in full — theory, questions and one hands-on task — and let two
or three people you know go through them. Their mistakes will tell you what
to rewrite before you invest time in the rest. If you teach a small group
rather than the public, see the LMS for a small team
page.
Try it on your own task
Create a repository — history, issues and pull requests from day one.
Was this helpful?