|
| 1 | +--- |
| 2 | +title: "LiaSkill: Creating LiaScript Courses with AI" |
| 3 | +slug: "liaskill-creating-liascript-courses-with-ai" |
| 4 | +date: 2026-04-30 |
| 5 | +draft: false |
| 6 | +image: "/images/post/liaskill/banner.png" |
| 7 | +tags: |
| 8 | + - AI |
| 9 | + - OER |
| 10 | + - Tutorial |
| 11 | + - Education |
| 12 | + - Authoring |
| 13 | +categories: |
| 14 | + - News |
| 15 | + - Feature |
| 16 | +author: "Jihad Hyadi" |
| 17 | +description: "LiaSkill is an AI skill that gives any LLM — Claude, ChatGPT, Gemini — structured knowledge of LiaScript syntax, so it can generate complete, interactive courses from a single prompt." |
| 18 | +--- |
| 19 | + |
| 20 | +Writing a LiaScript course from scratch means learning its Markdown dialect: how quizzes are formatted, how animations are triggered, how text-to-speech comments attach to slides. |
| 21 | +That knowledge barrier is real, and it slows down educators who just want to produce good content. |
| 22 | + |
| 23 | +**LiaSkill** removes that barrier. |
| 24 | +It is an AI skill — a structured knowledge file — that you attach to any large language model. |
| 25 | +Once attached, the model understands LiaScript syntax well enough to generate a complete, renderable course file from a plain-language description. |
| 26 | + |
| 27 | +--- |
| 28 | + |
| 29 | +### What it is |
| 30 | + |
| 31 | +LiaSkill is not a plugin or an extension. |
| 32 | +It is a small folder of Markdown files that document LiaScript's syntax in a format optimized for AI consumption: structured sections, explicit rules, and worked examples for every feature. |
| 33 | + |
| 34 | +``` |
| 35 | +liascript-skill/ |
| 36 | +├── SKILL.md # Main skill definition |
| 37 | +└── references/ |
| 38 | + ├── advanced.md # Macros, scripting, imports, custom quiz config |
| 39 | + ├── templates.md # Reusable course templates |
| 40 | + └── voices.md # Full list of supported TTS voices |
| 41 | +``` |
| 42 | + |
| 43 | +`SKILL.md` is the entry point and covers the full LiaScript syntax. |
| 44 | +The reference files handle the edges: advanced macro authoring, a library of ready-to-use templates, and the complete list of text-to-speech voices across dozens of languages. |
| 45 | +Upload the whole folder — or the packaged zip from the releases page — and the model gets all of it. |
| 46 | + |
| 47 | +Attach it to your AI assistant's context as a system prompt, a file upload, or a skills directory entry. |
| 48 | +From that point on, asking for a course, tutorial, or quiz will produce valid LiaScript output rather than generic Markdown. |
| 49 | + |
| 50 | +The skill covers: |
| 51 | + |
| 52 | +- **Course structure** — headers, sections, subsections, and the metadata block |
| 53 | +- **Quizzes** — text input, single/multiple choice, dropdowns, matrix, gap text, hints, and explanations |
| 54 | +- **Animations** — step-by-step reveal and grouped block effects |
| 55 | +- **Text-to-speech** — narrator comments, voice switching, and inline playback buttons |
| 56 | +- **Multimedia** — images, audio, video (YouTube, Vimeo, and others), iframes, and galleries |
| 57 | +- **Tables and charts** — Markdown tables that auto-render as interactive visualizations |
| 58 | +- **Code blocks** — syntax highlighting, executable code, and multi-file projects |
| 59 | +- **ASCII diagrams** — auto-rendered architecture and flow diagrams |
| 60 | +- **Surveys** — single/multi-select and free-text survey blocks |
| 61 | +- **Math** — inline and block LaTeX formulas |
| 62 | +- **Advanced** — macros, custom scripts, course imports, and HTML integration |
| 63 | + |
| 64 | +--- |
| 65 | + |
| 66 | +### How to use it |
| 67 | + |
| 68 | +Download the skill from the releases page as a ready-to-use zip, or clone the repository directly: |
| 69 | + |
| 70 | +{{< button link="https://github.com/LiaScript/LiaSkill/releases/latest" label="Download liascript-skill.zip" >}} |
| 71 | + |
| 72 | +```bash |
| 73 | +git clone https://github.com/LiaScript/LiaSkill |
| 74 | +``` |
| 75 | + |
| 76 | +How you attach it depends on your tool: |
| 77 | + |
| 78 | +- **Claude (claude.ai)** — upload the zip in Project Knowledge; claude.ai unpacks it and all files become available to the model |
| 79 | +- **Claude Code** — add `liascript-skill/` to your project's skills directory |
| 80 | +- **ChatGPT** — paste the contents of `SKILL.md` into the system prompt of a custom GPT, and upload the reference files as knowledge |
| 81 | +- **API / custom apps** — include the files as system messages before the user turn |
| 82 | + |
| 83 | +Once it is in context, describe what you want: |
| 84 | + |
| 85 | +> Create a LiaScript course introducing Python for beginners. Include 3 sections: variables, loops, and functions. Add a quiz after each section, use animations to reveal bullet points step by step, and include narrator comments for the key concepts. |
| 86 | +
|
| 87 | +The model will return a complete `.md` file ready to render. |
| 88 | + |
| 89 | +--- |
| 90 | + |
| 91 | +### Previewing the output |
| 92 | + |
| 93 | +Paste the generated file into the [LiaScript LiveEditor](https://liascript.github.io/LiveEditor/), or host it anywhere — GitHub, GitLab, a raw URL — and open it at: |
| 94 | + |
| 95 | +``` |
| 96 | +https://liascript.github.io/course/?YOUR_RAW_URL |
| 97 | +``` |
| 98 | + |
| 99 | +No build step, no server, no installation. |
| 100 | + |
| 101 | +--- |
| 102 | + |
| 103 | +### Why this matters |
| 104 | + |
| 105 | +LiaScript's power has always been its expressiveness — a single Markdown file can encode quizzes, animations, code execution, and narration. |
| 106 | +The cost has been that authors need to know the syntax. |
| 107 | + |
| 108 | +LiaSkill shifts that cost to the model. |
| 109 | +An educator who knows their subject can describe a course in plain language and receive a working LiaScript file. |
| 110 | +They can then edit, extend, and version it like any other text file — no proprietary format, no lock-in. |
| 111 | + |
| 112 | +The skill is open source and works with any model that accepts a system prompt or file context. |
| 113 | + |
| 114 | +{{< button link="https://github.com/LiaScript/LiaSkill" label="View LiaSkill on GitHub" >}} |
0 commit comments