Check a Lesson Before You Publish
A pre-publication checklist for reviewing a Lesson across planning, capture, interactivity, design, accuracy, technical integrity, and translation.
Run this checklist on every Lesson before you publish it. Work top to bottom. Each group targets a different dimension of Lesson quality, from planning through what the Learner sees in the Skyllful Simulator.
Is the Lesson planned and filed in the right place?
- Scope is clearly defined: the workflow steps the Lesson covers, the Learner roles it serves, and its objectives.
- The Lesson sits in the right Module and Course, inside the right Learning Program.
Are the Screen Replicas accurate?
- Every Screen Replica was converted in Replica Maker from a capture of the current production screen.
- Screen images are sharp, with no pixelation or blurring.
- Each Replica looks exactly like the screen the Learner uses on the job. Nothing was removed to simplify it.
- Elements are tagged for every interaction a step expects: clicks, text entry, and scrolls.
- Sensitive data was masked or replaced before the screen went into the Lesson.
Do the interactions work in every mode the Lesson ships in?
- Each mode the Lesson ships in was opened and walked end to end: Talkthrough, Walkthrough, Practice, Knowledge Check, or Video.
- Every step action does what the step expects, with no dead controls.
- Prompts appear where the Learner needs them and do not cover the element they point at.
Is the instructional design sound?
- The learning objective is clearly stated in the Lesson description.
- Voiceover scripts and on-screen instructions are clear and Learner-centered.
- Terminology is consistent. Acronyms and jargon are defined or avoided.
- Prompt styles match the Learning Program defaults, unless this Lesson deliberately overrides them.
Best practice: Keep a Lesson to about 15 steps. A longer workflow usually splits cleanly into two Lessons in the same Module, and a shorter Lesson is easier for a Learner to finish in one sitting.
Is the content accurate?
- Every step reflects the current production version of the application.
- Data and field values reflect realistic scenarios.
- Instructions are sequenced in the order the Learner performs them, with nothing missing.
- Business rules and validations are depicted correctly.
Is the Lesson technically clean?
- All media assets load and play.
- The Lesson moves from screen to screen without abrupt jumps.
- Images and thumbnails are in place where the Lesson calls for them.
- You previewed the Lesson and it behaved the way it does in the Lesson Builder.
Is the translated Lesson ready?
- Every text element is translated. A title nobody translated renders blank for the Learner, not in English.
- No element is still marked Unreviewed on the Translations screen. Unreviewed is the queue of machine translations nobody has checked.
- Translated text fits inside buttons, tooltips, and modal windows without overlapping or being cut off.
- Pronunciation and tone in translated voiceovers are clear and natural.
- A native speaker or certified translator reviewed the translation.
- Navigation and interactive elements behave the same as they do in the English Lesson.
Note: Do not run a bulk translation after a human review pass. Bulk translation replaces every title in its scope immediately, with no confirmation and no undo, and reviewed work is lost.
Frequently asked questions
Does passing this checklist mean Learners can see the Lesson?
No. Publishing makes a Lesson eligible. A Learner reaches it only when it is also included in an active assignment.
Can you edit a Lesson after it passes the checklist and gets published?
Yes. Editing a published Lesson creates a new version. What you cannot edit is a screen used in a published Lesson.
Who runs this checklist?
Whoever owns the Lesson runs it before publishing. On teams with a formal review step, the reviewer runs it again before approving.
Where do you check the interactions?
Preview the Lesson. Preview and Review Lessons covers the preview path and what each mode looks like to a Learner.
Skyllful Knowledge Base | Instructional Designers, Content Developers, Subject Matter Experts