Een cursus ontwikkelen met behulp van A.I.

Tips & tricks

Tim Dams

Voor wie is dit?

Alles wat volgt is proefondervindelijk gevonden. Roep wanneer iets niet klopt. Mensen helemaal rechts: ik reken op feedback.

Voor wie is dit?

Ah ja. En Kristof.

Origin story

Yves en Kelly vroegen 2 weken geleden op overleg of ik deze talk wou geven…uiteraard zei ik direct ‘okidoki!’

Tim from the past…

…had dat ook geantwoord. En week later diiiik spijt van gehad.

Tim van nu…

…zei dus ja , had een uur later een outline en 1 dag en 3 prompts later een eerste cursusversie die online beschikbaar stond.

Toegegeven, het trok op niets: maar er was tenminste een basis.

A Propos:

Cronos heeft me gecontacteerd, ze gaan wel de workshop hernoemen…

“Becoming a WrA.I.ter”

😏

Onze eerste stapjes. Remember?

Gevaar van A.I. is dat het altijd overtuigend antwoordt.

Het lag niet alleen aan je prompt

Prompten is al lang niet meer de core competentie.

Akkoord, het start bij je prompt, maar veel belangrijker zijn je ervaring en stijl als lesgever.

En hoe kan A.I. dat overnemen?!

Wij zijn toch uniek. Niet vervangbaar.

Toch?

Toch…?

Wat volgt is daarom een voorgestelde workflow (en een work-in-progress website met tips&tricks).

A.I. agnostisch…geprobeerd

Iedereen zit met een ander abonnement (of geen) en een andere toolset: browser, client, VS Code. Theoretisch werkt wat volgt op elke combinatie. 🤞

De workflow

Eén en twee is grotendeels zonder A.I. (sorry!).

Drie tot 7 is waar A.I. je leven fijner zal maken 😉.

1 Schrijf eerst als schrijver

Maak een ruwe outline en schrijf (een stuk) van je favoriete hoofdstuk.

Als je A.I. vanaf nul laat schrijven dan duwt hij de inhoud en toon. Stay in control 🤓 !

2 Zet je cursus in droge tekst

Markdown of gewone txt. Knip tot op de maat die je in één keer meegeeft: meestal één onderwerp. En trek je nog niets aan van je opmaak en afbeeldingen.

Tijd om de A.I. te temmen

3 Maak een contextmap, en hou ze proper

context/: hierin zit wat een collega nodig heeft om je vak over te nemen. K.I.S.S.

content/: hier komen je cursushoofdstukken, en later je afbeeldingen.

4 Zet je regels in een bestand: de handleiding voor je agents

4 Regelbestand inhoud?

Een tekstbestand van een halve pagina dat je A.I. bij elke nieuwe vraag opnieuw leest.

Zet er alles dat je telkens opnieuw moet zeggen (alsof het een student is 😉)

Zet er zeker een ‘plan van je map’ in, waar je beschrijft waar alle bestanden staan en wat hun nut is.

Vergelijk het met een studiewijzer.

4 Regelbestand voorbeeldje

## Toon
- Vlaams, je-vorm, korte zinnen.
- Vet is voor de zin die je in de les twee keer zou zeggen.

## Niet doen
- Geen em-dashes. Een dubbele punt of een nieuwe zin.
- Geen wijze slotzin: stop na het laatste feit.
- Getallen tot twintig voluit.

## Waar staat wat
- 'context\': alle informatie die je nodig hebt om de perfecte teksten te maken. Lees deze altijd voor je aan iets nieuws begint.
  - `toonvoorbeeld.md`: mijn hoofdstuk over casting. Hier zit mijn stem in.
  - `gettingstarted.md`: de huisregels waar deze talk uit komt.
- 'content\': hier komen de slides, handboek, etc.
- 'jokes\': eindig ieder hoofdstuk met 1 mop uit deze folder. Voor de rest negeer je deze folder

• Tip: Laat de A.I. het regelbestand nalezen en er feedback op geven.

“Ja maar, ik werk in een chatvenster…” (Claude vb.)

ChatGPT heeft Projects met dezelfde velden, Copilot heeft notebooks. Zoek in jouw venster waar je bestanden blijven staan.

5 Laat de A.I. bijhouden wat je corrigeert

5 Van losse correcties naar één checklist

• Elke regel hier stond eerst als correctie in een chat.
• improve.md wordt vanaf dan meegelezen zoals je regelbestand zelf: de A.I. past toe wat ze daar noteerde.
• Beter dan “ik zal op het einde van de sessie al m’n remarks wel even opschrijven”…dat doe je toch nooit.😒
• Tip: neem de regels geregeld door (soms neemt de A.I. vreemde beslissingen, en dan moet je ze corrigeren).

5 En daar komen je ‘.skills’ uit

Figuren, oefeningen, examenvragen: elke taak die terugkeert.

5 Hoe werkt zo’n skill?

Een gewoon tekstbestand dat je zelf schrijft: het recept voor die ene taak.

5 Voorbeeld van mijn skill voor de illustraties

• Meeste tekeningen in deze talk zijn met deze skills gemaakt.
• Sommige zijn met behulp van ChatGpt Images 2.0 gemaakt.
• Tip: laat je imagegen prompts door de A.I. uitschrijven.

A propos: stap 5 van deze skill is:

“Deze stap nooit overslaan. Bekijk de gerenderde PNG met de Read tool. rough.js geeft geen foutmelding bij lelijke output, dus je moet echt kijken. Loop de checklist in references/checklist.md af, corrigeer het script en render opnieuw tot het klopt.”

5 Wanneer maak je een skill, en typ je die zelf?

Wanneer je jezelf dezelfde reeks commando’s hoort dicteren. Of A.I. telkens het wiel moet heruitvinden.

• Skills schrijf je niet zelf…Allez, ik toch niet.
• Vraag het op het einde van een chat: “schrijf wat we net gedaan hebben als een skill: de stappen in volgorde, met de commando’s en met wat er misliep.”
• Controleer de skill, en “installeer” hem.

• Tip: installeer niet iedere skill die je online vindt. Broedt op je eigen skills. Remember: you’re the boss! 🧑‍🍳

6 Kijk na

Het verschil tussen een cursus en A.I.-slob.

• De A.I. zegt nooit dat hij het niet zeker weet.

• Zelf lezen dus: de getallen, de namen, de bronnen, en of het klopt met wat jij in de les vertelt.

• Tokens te veel? Laat A.I. de codevoorbeelden zelf runnen en testen.

• Wat je hier corrigeert, gaat naar improve.md van stap vijf.

6 Huur het A(I)-team

Laat de A.I. je teksten nalezen, maar telkens in een andere rol.

• “Lees dit hoofdstuk als een student met dyslexie. Waar haak je af?”
• “Je bent eindredacteur bij Pearson en wil dit hoofdstuk de finishing touches geven voor je het in miljoenen oplage afdrukt. Waar zitten de easy wins? Wat gaat de uitgeverij geld kosten?”
• “Stel dat de Spaanse inquisitie mijn cursus leest: welke uitspraken moet ik zeker online verifiëren?”

7 En finaal de belekes, pdf, slides, etc!

Nu begint de tokenburning … en fun 😁.

Maar dat is voor een andere keer…

Ook deze slides doorliepen deze flow

Deze talk, als map

Wat je (hopelijk) mee naar huis neemt

Hoe heet het bij jou? In je venster

	je vaste plek heet	je regels staan in	een skill is
Claude	een Project	de projectinstructies	een Skill, als zip of .md opgeladen
ChatGPT	een Project	de projectinstructies	een document in je project, of een eigen GPT
Gemini	een Gem, of een Notebook	de instructies van je Gem of notebook	een tweede Gem
Copilot	een Notebook	de instructies van je notebook	een tweede notebook

Deze info heeft Claude verzameld…Graag feedback (nadien) of dit klopt.

Hoe heet het bij jou? In een map op je pc

	waarmee je je map opent	je regels staan in	je skills staan in
Claude	de Claude-appCowork, of Claude Code	CLAUDE.md	.claude/skills/
ChatGPT	Codexin de ChatGPT-app, of in VS Code	AGENTS.md	~/.codex/skills/
Gemini	Antigravityde editor van Google zelf	AGENTS.mdof GEMINI.md	.agents/skills/
Copilot	VS Codeniet de Copilot in Word	AGENTS.md	.github/skills/

Drie van de vier lezen AGENTS.md, en in elke skills-map zit een SKILL.md.

Ohja…de site

Op vraag van mijn vrouw…en Yves 😉

Vier delen

Wat er nog niet af is

• De galerij groeit nog. Ken je een cursus, site of cursusmap die erin hoort, laat het weten.
• Grote stukken van de teksten voelen nog A.I. aan.
• Of de bevrager de juiste vragen stelt, weet ik niet. Dat merk ik pas wanneer iemand anders hem doorloopt met zijn eigen vak in zijn hoofd.

Ga naar timdams.github.io/websiteCursusAISchrijven, doorloop de bevrager met je eigen vak in je hoofd, en stuur me terug waar je vastliep of wat er ontbreekt.

Bedankt!