A visual, single-page guide to the 7-command pipeline for generating WSQ courseware at Tertiary Infotech Academy — from a blank project folder all the way to a complete, lab-aligned courseware set (PPT, Learner Guide, Lesson Plan, Assessment), audited at every gate and published to Google Drive and the LMS-TMS.
https://tertiarycourses.github.io/wsqcourseware/
Before step 1, install the WSQ courseware toolchain — skills, slash commands, the courseware-qa agent and the hooks — from tertiarycourses/wsqskills into your user config (~/.claude), so every course project can import from it:
npx github:tertiarycourses/wsqskills --user # into ~/.claude (every project)
npx github:tertiarycourses/wsqskills # into the current course repo (./.claude)The installer copies skills/, commands/, agents/, scripts/ and hooks/ into the target .claude/ and registers the three hooks in its settings.json. Existing files are never overwritten unless you pass --force — a course repo often carries a course-customised generator. Verify inside a course repo with /courseware-qa.
Run these seven commands, in order, from the course project folder:
/wsq-setup # 1. install / update the WSQ toolchain
/courseware-gen # 2. generate the PPT, LG, LP (+ PDFs)
/courseware-qa # 3. audit the courseware — fix, regenerate, re-run
/assessment-gen # 4. generate the WA + PP/Case Study (+ answer keys)
/courseware-qa # 5. audit the assessment — fix, regenerate, re-run
/gdrive-push # 6. publish to the Google Drive courseware folder
/tms-push # 7. set the links + question papers on the LMS-TMS
| # | Command | What happens |
|---|---|---|
| 1 | /wsq-setup |
Installs the full toolchain — skills, commands, the courseware-qa agent, the push scripts and the three hooks — into the project's .claude/. Put the existing PPT and the existing assessment under reference/ first: the generators mirror them. |
| 2 | /courseware-gen |
Generates the PPT, the Learner Guide (LG + Markdown mirror) and the Lesson Plan (LP), 100% aligned to the course labs, with a PDF for all three. Superseded versions are archived. |
| 3 | /courseware-qa |
Audits the deck, LP and LG against the 7-point PPT checklist — rendering every page to an image and looking at it. Fix, regenerate, re-run until it passes. |
| 4 | /assessment-gen |
Generates the WA (SAQ) plus one practical instrument — PP or Case Study — each as a question paper and an answer key. Mirrors the original: same question count, same instrument, same K/A mapping and timings. |
| 5 | /courseware-qa |
Audits the assessment against the 5-point checklist — question count, labs alignment, full K & A coverage, cover page, instrument preserved. |
| 6 | /gdrive-push |
Uploads the full set (incl. the assessments) to the Drive courseware folder, archiving old versions, and returns the anyone-with-link viewer links. |
| 7 | /tms-push |
Writes the links onto the course record at lms-tms.tertiaryinfotech.com — Trainer Slide (PPT), Learner Slide (PDF, from the LG folder), LG (PDF), LP (PDF) — and attaches the question papers. |
⚠️ DO NOT push the assessment to GitHub. It is confidential — it goes to Google Drive only. Keepassessment/git-ignored.🚫 Never upload an answer key to the LMS. Any
Answer to …file is trainer-only: it lives on Google Drive and never reaches the LMS, a learner-visible field, or GitHub./tms-pushattaches the WA question paper and the PP/CS question paper only.
- All admin pages present in the PPT
- File names follow the house convention, e.g.
<<Course Title>>-version - LG contains step-by-step detailed lab guides, plus a Markdown mirror
- LP references the slide numbers
- PDF exported for PPT, LG and LP
- Practice exam link added to the PPT — search the associated exam at exams.tertiaryinfotech.com
⚠️ Any change to the PPT means the LP must be re-checked. If you add, remove or reorder slides, update the Lesson Plan so every activity references the correct slide number — the LP slide numbers must always match the current deck.
- The number of questions remains the same as the original paper
- The instrument type is preserved — a Case Study stays a Case Study; a PP stays a PP
- The PP or CS follows the labs — every task cites its lab, and the model answer is the lab procedure
- Every K and every A is covered — the WA covers the K codes, the PP/CS covers the A codes; a missing K or A is a failure, not a caveat
Template reference: TGS-2025054472-NetworkPlus
Before any slide deck is signed off, it must pass this 7-point visual audit — every point a diagram, profile card or screenshot, not a wall of text:
- Two trainer profiles — a general trainer template card and a named Dr Alfred Ang profile
- Download course material visual — how to get the courseware from lms-tms.tertiaryinfotech.com
- Assessment Flow visual — WA → PP and the sign-off path as a flow diagram
- Practice Exam — the matching exam from exams.tertiaryinfotech.com on a visual slide
- Version number on the cover page — matching the
<<Course Title>>-versionfilename - Single version on the cover — only one version number on the PPT cover, no duplicate or conflicting labels
- Assessment cover pages — every assessment (WA, PP, Case Study) carries the WSQ cover page before its questions
🖼️ Golden rule — more visuals, not just text. Favour tile grids, flow diagrams, profile cards and screenshots over bullet walls.
Before any assessment set is signed off, it must pass this 5-point audit. The rewritten assessment stays structurally identical to the original — only the content changes:
- Same number of questions — exactly as many questions as the original assessment; never add, drop or merge
- PP / CS follows the labs — the Practical Performance (PP) or Case Study (CS) tasks align to the actual labs and activities in the PPT and LG
- Full K & A coverage — every K and A criterion is assessed: the WA covers the K codes, the PP or CS covers the A codes
- Cover page on every doc — the assessment, LG and LP each carry the WSQ cover page (course title, logos, UEN)
- Never swap the instrument — if the original is a Case Study it stays a Case Study; never convert CS → PP (or PP → CS)
📐 Golden rule — mirror the original. Same question count, same instrument, same K/A mapping and timings; rewrite only the content so it matches the current slides and labs.
- 🎯 Interactive step navigation pills with scroll-spy highlighting
- 📜 Animated timeline that reveals each step on scroll
- 📋 One-click copy buttons on every command and prompt block
- 📊 Scroll progress bar
- 📱 Fully responsive — works on mobile and desktop
- ⚡ Zero dependencies — one self-contained HTML file
wsqcourseware/
├── .github/
│ └── workflows/
│ └── deploy-pages.yml # GitHub Pages auto-deployment
├── index.html # The complete one-page site (HTML + CSS + JS inline)
├── screenshot.png # Homepage screenshot
└── README.md
No build step needed:
git clone https://github.com/tertiarycourses/wsqcourseware.git
cd wsqcourseware
open index.html # or: python3 -m http.server 8000- Tertiary Infotech Academy Pte Ltd — WSQ course provider
- SkillsFuture Singapore (WSQ) — Workforce Skills Qualifications framework
Powered by Tertiary Infotech Academy Pte Ltd