diff --git a/.changeset/teach-shared-assets.md b/.changeset/teach-shared-assets.md new file mode 100644 index 0000000..35724d1 --- /dev/null +++ b/.changeset/teach-shared-assets.md @@ -0,0 +1,5 @@ +--- +"mattpocock-skills": patch +--- + +Allow the **`teach`** skill to share code between lessons. Shared stylesheets, simulator code, and any code reused across lessons now live in `./assets/`. diff --git a/skills/productivity/teach/SKILL.md b/skills/productivity/teach/SKILL.md index 2fad9a3..93298cb 100644 --- a/skills/productivity/teach/SKILL.md +++ b/skills/productivity/teach/SKILL.md @@ -16,6 +16,7 @@ Treat the current directory as a teaching workspace. The state of their learning - `RESOURCES.md`: A list of resources which can be explored to ground your teaching in contextual knowledge, or to acquire knowledge and wisdom. Use the format in [RESOURCES-FORMAT.md](./RESOURCES-FORMAT.md). - `./learning-records/*.md`: A directory of learning records, which capture what the user has learned. These are loosely equivalent to architectural decision records in software development - they capture non-obvious lessons and key insights that may need to be revised later, or drive future sessions. These should be used to calculate the zone of proximal development. They are titled `0001-.md`, where the number increments each time. Use the format in [LEARNING-RECORD-FORMAT.md](./LEARNING-RECORD-FORMAT.md). - `./lessons/*.html`: A directory of lessons. A **lesson** is a single, self-contained HTML output that teaches one tightly-scoped thing tied to the mission. This is the primary unit of teaching in this workspace. +- `./assets/*`: Shared code used across lessons — stylesheets, simulator code, anything two or more lessons reuse. Lessons may link to these rather than duplicating the code inline. - `NOTES.md`: A scratchpad for you to jot down user preferences, or working notes. ## Philosophy