mirrors/mattpocock-skills
2
0
Fork 1
mirror of https://github.com/mattpocock/skills.git synced 2026-06-25 08:24:06 +00:00
Code Issues Projects Releases Packages Wiki Activity

Enhance lesson guidelines by emphasizing the importance of citations and interactive elements for improved user engagement

Browse source
This commit is contained in:
Matt Pocock 2026-06-06 10:10:38 +01:00
commit dbcb1bda03
1 changed files with 1 additions and 9 deletions
Download patch file Download diff file Expand all files Collapse all files

10
skills/in-progress/teach/SKILL.md
View file

@ -63,7 +63,7 @@ A user may tell you that they already know about that topic. If so, record it in
Lessons should be designed around a skill the user is going to learn. The knowledge in the lesson should be only what's required to acquire that skill. You teach the knowledge first, then get the user to practice the skills via an interactive feedback loop.
Knowledge should first be gathered from trusted resources. Use `RESOURCES.md` to keep track of them.
Knowledge should first be gathered from trusted resources. Use `RESOURCES.md` to keep track of them. Lessons should be littered with citations - links to external resources to back up any claim made. This increases the trustworthiness of the lesson, and gives the user a path to acquire more knowledge if they want to go deeper.
Each lesson should contain a reminder to ask followup questions to the agent. The agent is their teacher, and can assist with anything that's unclear.
@ -71,14 +71,6 @@ Each lesson should contain a reminder to ask followup questions to the agent. Th
Skills should be taught through interactive lessons. There are several tools at your disposal:
Lessons should be littered with citations - links to external resources to back up any claim made.
Lessons should be as interactive as possible, with "try this" callouts to let the user try the knowledge.
Once the user has read the knowledge, allow them to ask questions about it. Answer their questions directly, and amend the lesson if needed (or produce another one). At this point, you can amend the glossary if it appears clear they understand a term.
There are several tools at your disposal:
- Interactive lessons, using quizzes and light in-browser tasks
- Lessons which guide the user through a list of real-world steps to take (for instance, yoga poses)
- In-agent quizzes, where you ask the user scenario-based questions about what they've learned