Educates
Docs (external site)Hub (external site)Educates on GitHubGet startedSite map
Educates
Get started

AI authoring skillsAuthoring

Plan a course and draft its workshops with an AI agent

Two agent skills give an AI coding agent what it needs to know about Educates. The workshop authoring skill creates a workshop when you ask for one, with its directory, its workshop.yaml and its instruction pages. The course design skill plans a course first, from a single workshop to one in several parts, and writes a blueprint for each workshop that the authoring skill then builds. Both are developed and tested with Claude.

Get startedRead the README for AI authoring skills (external site)

What you can do with it

  • An instruction page the workshop authoring skill wrote, with a clickable action for each step, open in a Session's editor.

    Create a workshop by asking for one

    Ask Claude for an Educates workshop on a topic, or invoke /educates-workshop-authoring, and the skill creates the project, with the directory layout Educates expects, a workshop.yaml with the session applications the workshop needs, and instruction pages that follow Educates conventions.

  • A course plan from the course design skill, with its workshops marked core or elective.

    Plan a course before you write it

    The course design skill organizes topics into workshops, for anything from a single workshop idea to a course in several parts, and marks each workshop as spine or elective. For a small course it keeps its steps short.

  • The detailed plan the course design skill wrote for one workshop: its metadata, its configuration and its learning objectives.

    A blueprint for each workshop

    For each workshop, the course design skill writes a detailed plan. The workshop authoring skill then builds the workshop from it, with its configuration, instruction pages and exercise files.

  • The course's task list, by workshop and priority, with the work to do next.

    Pick up a course you already have

    Point the course design skill at an existing course, and it audits the workshops and bootstraps the planning documents. It tracks the work left across workshops, suggests what to do next by priority, and guides how the course grows.

How you use it

Add each skill to your agent from its repository:

Terminal window
npx skills add https://github.com/educates/educates-workshop-authoring-skill
npx skills add https://github.com/educates/educates-course-design-skill

To pin a version instead, download the .skill file from a tagged release and install it with the Claude Code CLI, here version 4.1 of the workshop authoring skill:

Terminal window
curl -fLO https://github.com/educates/educates-workshop-authoring-skill/releases/download/4.1/educates-workshop-authoring.skill
claude skill install educates-workshop-authoring.skill

Then ask Claude for an Educates workshop or course, and it picks the skill from what you ask, or invoke a skill by name:

/educates-course-design
/educates-workshop-authoring

Plan the course with the first, then build each workshop from its blueprint with the second. What they write is a workshop's files: run it on a local Educates, as local authoring shows, before anyone else takes it.

Limits

What it does not do, and what it needs from you, so you can judge it before you build on it.

Where to try it

Try it from its repositories

Each repository's README says how to install it and how to use it.

Read more

Try it yourself, or talk to us

Get started runs Educates on your laptop with a first workshop in a few commands. Get help is where you ask the community, and where you can hire the people who build Educates.

Get startedGet help