Documentation

Modules and components

How a Skillsail training is put together: modules, ordered components, and the three component types.

Last updated September 14, 2026View as Markdown

A Skillsail training is called a module. Each module is a list of components shown to the learner in order. Components are the pieces of content a learner clicks through.

This page explains what those pieces are and when to use which.

Module

A module is the training itself. It has:

A title shown to learners.
A short link identifier used in shareable URLs.
A list of components in display order.
Settings for languages, theme (colors and typography), and completion criteria.

A module also keeps track of related material attached to it — images, video, voiceover, uploaded files, share settings, and a history of saved versions.

Component types

Every component in a module is one of three types.

A slide is a content unit. It can include a title, formatted text, and optional media (one or more images, video, or voiceover). Up to four images can be arranged in a responsive stacked, split, or gallery layout, and learners can select any image to open a larger view. Slides are the main way to present material.

Use slides for explanation, narrative, examples, and anything you want the learner to read or watch. Multiple images are still presentation content: use a question for a scored check or an interactive activity when the learner's action is part of the objective.

For visual emphasis, a slide can use a native statement, note, quote, hero, two-column, or image-overlay design. These remain presentation slides: their text follows the standard translation workflow, their media uses managed slide assets, and their voiceover stays linked to every visible text field. Image overlays use one managed image and retain a readable text surface when that image is unavailable.

For two-column slides, ask for an overall title and separate left and right column headings. The headings and text align on wide screens and stack on small screens.

Question

A question is a quiz item. It contains:

A question prompt
A bounded answer contract such as options, blanks, matching pairs, or image regions
One correct answer or an exact set of correct answers
Optional feedback messages for correct and incorrect answers

Questions can use text, managed image choices, a managed hotspot image with an equivalent keyboard-friendly region list, or several blanks embedded in a passage. Use questions when you want a scored check or a quiz-style assessment. Questions feed into score-based completion (see Themes and completion).

Interactive activity

An interactive activity is a self-contained, free-form learning moment. It is the most flexible component type and covers things that do not fit a slide or a quiz question — for example a phishing detection game, a branching scenario, a flash-card drill, a sorting exercise, or a guided decision walkthrough.

See Interactive content for guidance on when to choose this type.

Ordering

Components are shown to the learner in the order they appear in the module. You can:

Move a single slide, question, or activity to a different position.
Reorder the whole list at once.

Slides, questions, and interactive activities can appear in any order. A common pattern is a few slides to set context, then a question or two to check understanding, then a final summary slide.

Adding or editing content

You can build a module by:

Asking Skillsail — describe the training you want and let Skillsail draft the slides and questions for you.
Editing directly — change a slide's text, add a question, replace an image, or reorder things at any time.
Asking an AI assistant via MCP — connect a Skillsail-compatible assistant (see AI assistants) and ask it to add a slide, rewrite a question, translate the module, or publish it.

All three paths produce the same result. You can mix them freely on the same module.

In web chat, the assistant can use the slide shown in your preview as context when you refer to “this slide.” You can still name a different slide in your request.

When to use which component

Use slides for explanation, storytelling, and media.
Use questions when you want a scored quiz check.
Use interactive activities for practice, games, scenarios, and anything more open-ended.