Get the FREE Ultimate OpenClaw Setup Guide →

canvas-course-builder

Scanned
npx machina-cli add skill vishalsachdev/canvas-mcp/canvas-course-builder --openclaw
Files (1)
SKILL.md
6.3 KB

Canvas Course Builder

Build complete Canvas course structures from a natural language description, a JSON template, or by cloning an existing course. Creates modules with pages, assignments, discussions, and proper organization in one workflow.

Prerequisites

  • Canvas MCP server must be running and connected.
  • Authenticated user must have instructor or designer role in the target course.
  • Target course must already exist in Canvas (this skill populates it, does not create the course itself).

Modes

This skill operates in three modes:

Mode 1: Build from Spec (default)

The user describes the course structure in natural language or provides a structured spec.

Mode 2: Build from Template

Load a saved JSON template to scaffold a course.

Mode 3: Clone from Existing Course

Read the structure of Course A and replicate it into Course B.

Steps

1. Determine Mode and Gather Input

Ask the user how they want to build:

How would you like to build the course structure?

  1. Describe it -- Tell me the structure (e.g., "15 weeks, each with an overview page, assignment, and discussion")
  2. From template -- Load a saved template file
  3. Clone another course -- Copy structure from an existing course

For Mode 1 (Spec): Ask for:

  • Target course (code or ID)
  • Number of modules/weeks/units
  • Module naming pattern (e.g., "Week N: [Topic]")
  • Standard items per module (overview page, assignment, discussion, etc.)
  • Any module-specific variations (midterm week, final project, etc.)

For Mode 2 (Template): Ask for the template file path. Parse the JSON template.

For Mode 3 (Clone): Ask for:

  • Source course (code or ID)
  • Target course (code or ID)
  • Call get_course_structure(source_course) to read the full structure

2. Generate Structure Preview

Build a preview of what will be created and present it to the user:

## Course Build Plan: [Course Name]

### Structure: 15 modules x 4 items each = 60 items total

| Module | Page | Assignment | Discussion | SubHeader |
|--------|------|------------|------------|-----------|
| Week 1: Introduction | Overview | HW 1 (10 pts) | Week 1 Forum | Materials |
| Week 2: Fundamentals | Overview | HW 2 (10 pts) | Week 2 Forum | Materials |
| ... | ... | ... | ... | ... |
| Week 14: Review | Overview | -- | Review Forum | Materials |
| Week 15: Final | Overview | Final Project (100 pts) | -- | Materials |

### Items to create:
- 15 modules
- 15 overview pages
- 14 assignments
- 14 discussion topics
- 15 subheaders
- Total: 73 Canvas objects

Shall I proceed?

3. User Approves or Modifies

Wait for explicit approval. The user may:

  • Approve as-is
  • Request modifications (add/remove items, change naming, adjust points)
  • Cancel

Do NOT proceed without approval.

4. Execute Creation

Create items in dependency order:

  1. Modules first: Call create_module for each module (unpublished by default for safety)
  2. Pages: Call create_page for each overview page
  3. Assignments: Call create_assignment for each assignment (unpublished)
  4. Discussions: Call create_discussion_topic for each forum
  5. Module items: Call add_module_item to link each created item to its module

Track progress and report as you go:

Creating modules... 15/15 done
Creating pages... 15/15 done
Creating assignments... 14/14 done
Creating discussions... 14/14 done
Linking items to modules... 58/58 done

If any creation fails, log the error and continue with remaining items.

5. Report Results

## Build Complete: [Course Name]

### Created:
- 15 modules
- 15 overview pages
- 14 assignments
- 14 discussion topics
- 58 module items linked

### Failed (0):
None

### Next Steps:
- All items created **unpublished** -- publish when ready
- Add content to overview pages
- Set due dates on assignments
- Run `/canvas-course-qc` to verify structure

6. Save as Template (Optional)

After building, offer to save the structure as a reusable template:

Would you like to save this structure as a template for future courses?

If yes, call get_course_structure(target_course) and save the output as a JSON file.

MCP Tools Used

ToolPurpose
list_coursesFind available courses
get_course_structureRead source course for cloning; verify after build
create_moduleCreate each module
create_pageCreate overview/content pages
create_assignmentCreate assignments
create_discussion_topicCreate discussion forums
add_module_itemLink items to modules
update_modulePublish modules when ready

Template Format

Templates are JSON files with this structure:

{
  "template_name": "Standard 15-Week Semester",
  "modules": [
    {
      "name_pattern": "Week {n}: {topic}",
      "items": [
        {"type": "SubHeader", "title_pattern": "Week {n} Materials"},
        {"type": "Page", "title_pattern": "Week {n} Overview"},
        {"type": "Assignment", "title_pattern": "HW {n}", "points": 10},
        {"type": "Discussion", "title_pattern": "Week {n} Discussion"}
      ]
    }
  ],
  "special_modules": [
    {"position": 8, "name": "Midterm Review", "items": [{"type": "Page", "title": "Midterm Study Guide"}]},
    {"position": 15, "name": "Final Project", "items": [{"type": "Assignment", "title": "Final Project", "points": 100}]}
  ]
}

Example

User: "Build a 15-week structure for BADM 350 with a weekly overview page, homework, and discussion"

Agent: Generates preview, asks for approval, creates 60+ items.

User: "Clone the structure from CS 101 into CS 102"

Agent: Reads CS 101 structure, generates preview for CS 102, asks approval, creates matching structure.

Notes

  • All items are created unpublished by default for safety.
  • Content is not copied when cloning -- only structure (module names, item types, organization).
  • For content migration, copy page bodies using get_page_content + create_page with the body.
  • Run canvas-course-qc after building to verify the structure is complete and consistent.

Source

git clone https://github.com/vishalsachdev/canvas-mcp/blob/main/skills/canvas-course-builder/SKILL.mdView on GitHub

Overview

Canvas Course Builder scaffolds a complete course structure from a natural-language spec, a saved JSON template, or by cloning an existing course. It creates modules, pages, assignments, and discussions in one workflow, keeping content organized and ready for use. The target course must exist on Canvas, the Canvas MCP server must be running, and the user must have an instructor or designer role.

How This Skill Works

The tool operates in three modes: Build from Spec, Build from Template, or Clone from an Existing Course. It gathers input, generates a structure preview, and requires explicit user approval before creation. On execution, it creates modules first, then pages, assignments, discussions, and finally links items to their modules in dependency order.

When to Use It

  • Build a course structure from a natural language or formal spec
  • Scaffold from a saved JSON template for rapid replication
  • Clone the structure from an existing course to a new term
  • Set up a new course quickly without manual item-by-item creation
  • Bulk-create standard module content (overview, assignments, discussions) across weeks

Quick Start

  1. Step 1: Choose mode (Describe it, From template, or Clone another course) and provide target course identifiers
  2. Step 2: Generate a structure preview and review it
  3. Step 3: Approve and execute the creation; modules, pages, assignments, and discussions will be created in order

Best Practices

  • Verify prerequisites: Canvas MCP server is running, you have an instructor or designer role, and the target course exists
  • Define module naming patterns and standard items before building
  • Review the structure preview and adjust counts, names, or points before approval
  • Unpublish items by default and publish only after explicit approval
  • Test the workflow in a sandbox or small course before broader use

Example Use Cases

  • Create a 12-week intro course from a natural-language spec with weekly overviews, an assignment, and a discussion
  • Clone the structure of a successful course into a new term to reuse modules and content
  • Load a JSON template to scaffold standardized compliance training
  • Bulk-create a 15-week course with 15 modules and consistent weekly content
  • Bulk-copy a course structure across multiple courses to standardize offerings

Frequently Asked Questions

Add this skill to your agents
Sponsor this space

Reach thousands of developers