canvas-discussion-facilitator
Skill310 starsChanged 2 months agoMITView on GitHub
Discussion forum facilitator for Canvas LMS. Helps students and educators browse, read, reply to, and create discussion posts. Trigger phrases include "discussion posts", "reply to students", "check discussions", "forum participation", "post a discussion", or any discussion-related Canvas task.
We split this skill into the rules it gives an agent
22 rules. About 0 are common, 9 are distinctive, and 13 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈9
Distinctive · estimate
This author's own choices. Worth a look.
13
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 12
Canvas MCP server: must be running and connected to the agent's MCP client.
- Distinctive: line 20
Ask the user which course to work with.
- Very specific: line 22
If the user does not specify, use list_courses to show active courses and prompt:
- Very specific: line 28
Call the MCP tool list_discussion_topics with the course identifier to retrieve all discussion forums.
- Very specific: line 62
If a post is truncated or the user wants the complete text, call get_discussion_entry_details.
- Very specific: line 74
When the user wants to respond to a specific post, call reply_to_discussion_entry.
- Distinctive: line 85
Only send after explicit approval
- Very specific: line 89
When the user wants to add a new post to an existing discussion (not a reply), call post_discussion_entry.
- Very specific: line 100
When the user needs an entirely new discussion forum, call create_discussion_topic.
- Very specific: line 117
Call list_discussion_topics to get all discussion forums in the course.
- Distinctive: line 142
After identifying non-participants, offer to:
- Distinctive: line 149
When an educator wants to reply to student posts:
- Very specific: line 151
Read the full post with get_discussion_entry_details (include replies for context).
- Very specific: line 159
Call list_discussion_topics to see all active discussions.
- Very specific: line 160
Call list_discussion_entries with include_full_content=true to read posts.
- Very specific: line 165
Read the target post with get_discussion_entry_details.
- Distinctive: line 193
Read before replying: Always read the full post and its replies before drafting a response.
- Distinctive: line 194
Check for existing similar posts: Before posting a new entry, scan existing posts to avoid duplicating what others have already said.
- Distinctive: line 195
Reference specific points: When replying, quote or paraphrase specific parts of the original post.
- Very specific: line 196
Confirm before sending: Always show draft content to the user for approval before calling any write tool (reply_to_discussion_entry, …
- Very specific: line 198
Mind the timing: Check delayed_post_at and lock_at dates on topics.
- Distinctive: line 199
Anonymization for educators: When reviewing student participation, rely on anonymous IDs if anonymization is enabled.
≈ “Common” is an estimate: at least 1 in 5 of the 308,232 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Canvas Discussion Facilitator
Facilitate discussion forum activity in Canvas LMS -- browse topics, read posts, reply to students, create new discussions, and monitor participation. Works for both students and educators.
Prerequisites
- Canvas MCP server must be running and connected to the agent's MCP client.
- The authenticated user can have any Canvas role (student, TA, or instructor). Tool access is governed by Canvas API permissions.
- FERPA-conscious handling (educators): Set
ENABLE_DATA_ANONYMIZATION=truein the Canvas MCP server environment to anonymize supported student identity fields in output. This control does not by itself establish compliance.
Steps
1. Identify the Course
Ask the user which course to work with. Accept a course code, Canvas ID, or ask them to pick from a list.
If the user does not specify, use list_courses to show active courses and prompt:
Which course should I look at discussions for?
2. Browse Discussion Topics
Call the MCP tool list_discussion_topics with the course identifier to retrieve all discussion forums.
Parameters:
course_identifier-- course code or Canvas IDinclude_announcements-- set tofalse(default) to see only discussions, ortrueto include announcements
Data to surface per topic:
- Topic ID and title
- Author name
- Posted date
- Number of entries (if available)
- Whether the topic is pinned or locked
Present the list so the user can pick a topic to drill into.
3. View Posts in a Discussion
Once the user selects a topic, call list_discussion_entries to retrieve posts.
Parameters:
course_identifier-- course code or Canvas IDtopic_id-- the selected discussion topic IDinclude_full_content-- set totrueto see complete post bodiesinclude_replies-- set totrueto see threaded replies
Data to surface per entry:
- Author name
- Posted date
- Message content (or preview)
- Number of replies
- Entry ID (needed for replying)
4. Read a Specific Post in Full
If a post is truncated or the user wants the complete text, call get_discussion_entry_details.
Parameters:
course_identifier-- course code or Canvas IDtopic_id-- the discussion topic IDentry_id-- the specific entry IDinclude_replies-- set totrueto also fetch all replies to this entry
Present the full post content along with any replies, timestamps, and author information.
5. Reply to a Post
When the user wants to respond to a specific post, call reply_to_discussion_entry.
Parameters:
course_identifier-- course code or Canvas IDtopic_id-- the discussion topic IDentry_id-- the entry being replied tomessage-- the reply content (HTML is supported)
Before sending, always:
- Show the draft reply to the user for confirmation
- Reference the original post so the user can verify context
- Only send after explicit approval
6. Post a New Top-Level Entry
When the user wants to add a new post to an existing discussion (not a reply), call post_discussion_entry.
Parameters:
course_identifier-- course code or Canvas IDtopic_id-- the discussion topic IDmessage-- the post content (HTML is supported)
Show the draft to the user and confirm before posting.
7. Create a New Discussion Topic
When the user needs an entirely new discussion forum, call create_discussion_topic.
Parameters:
course_identifier-- course code or Canvas IDtitle-- the discussion titlemessage-- the opening post / prompt for the discussiondelayed_post_at-- (optional) ISO 8601 datetime to schedule the discussion to appear laterlock_at-- (optional) ISO 8601 datetime to automatically lock the discussionrequire_initial_post-- set totrueif students must post before seeing classmates' responsespinned-- set totrueto pin the topic to the top of the discussion list
Confirm the title, content, and any scheduling options with the user before creating.
Educator Use Cases
Monitor Participation
- Call
list_discussion_topicsto get all discussion forums in the course. - For each topic, call
list_discussion_entriesto retrieve all posts. - Cross-reference posters against the class roster (use
list_usersorlist_submissionsto get enrolled students). - Identify students who have not posted in any active discussion.
Present participation as a summary:
## Discussion Participation: [Course Name]
### Topic: "Week 5 Reading Response" (due Mar 3)
- **Posted:** 28 / 32 students (88%)
- **Not posted:** Student_a1b2c3d, Student_e4f5g6h, Student_i7j8k9l, Student_m0n1o2p
### Topic: "Case Study Analysis" (due Mar 5)
- **Posted:** 15 / 32 students (47%)
- **Not posted:** [17 students listed]
### Students Missing Multiple Discussions
- Student_a1b2c3d -- missing 2 discussions
- Student_e4f5g6h -- missing 2 discussionsSend Reminders About Participation
After identifying non-participants, offer to:
- Post an announcement using
create_announcementwith a general reminder about discussion deadlines. - Message specific students using
send_conversationto contact students who are behind on participation.
Draft Thoughtful Replies
When an educator wants to reply to student posts:
- Read the full post with
get_discussion_entry_details(include replies for context). - Draft a reply that acknowledges the student's points, asks follow-up questions, or connects ideas to course material.
- Show the draft for educator review and revision before calling
reply_to_discussion_entry.
Student Use Cases
Browse and Catch Up on Discussions
- Call
list_discussion_topicsto see all active discussions. - Call
list_discussion_entrieswithinclude_full_content=trueto read posts. - Summarize key themes or arguments across posts to help the student catch up quickly.
Reply to Classmates
- Read the target post with
get_discussion_entry_details. - Help the student draft a reply that engages substantively with the original post.
- Confirm and send via
reply_to_discussion_entry.
Post a New Entry
- Review existing posts with
list_discussion_entriesto avoid duplicating points already made. - Help the student draft a post that adds a distinct perspective or builds on the conversation.
- Confirm and send via
post_discussion_entry.
MCP Tools Used
| Tool | Purpose |
list_courses | Find the target course |
list_discussion_topics | Browse all discussion forums in a course |
list_discussion_entries | View posts within a discussion topic |
get_discussion_entry_details | Read a single post with full content and replies |
get_discussion_topic_details | Get metadata about a discussion topic |
reply_to_discussion_entry | Reply to an existing post |
post_discussion_entry | Add a new top-level post to a discussion |
create_discussion_topic | Create a new discussion forum |
create_announcement | Post a course announcement (educator) |
send_conversation | Message specific students through Canvas (educator) |
list_users | Get enrolled students for participation tracking (educator) |
Best Practices
- Read before replying. Always read the full post and its replies before drafting a response. This avoids repeating points and shows engagement with the conversation.
- Check for existing similar posts. Before posting a new entry, scan existing posts to avoid duplicating what others have already said. Build on or respectfully challenge existing arguments instead.
- Reference specific points. When replying, quote or paraphrase specific parts of the original post. This makes the reply more substantive and shows careful reading.
- Confirm before sending. Always show draft content to the user for approval before calling any write tool (
reply_to_discussion_entry,post_discussion_entry,create_discussion_topic,create_announcement). - Respect discussion settings. Some discussions require an initial post before viewing others (
require_initial_post). If a student cannot see other posts, they need to post first. - Mind the timing. Check
delayed_post_atandlock_atdates on topics. Do not attempt to post to locked discussions. - Anonymization for educators. When reviewing student participation, rely on anonymous IDs if anonymization is enabled. The Canvas MCP server preserves functional user IDs for messaging while anonymizing display names.
Example
User (educator): "Show me who hasn't posted in the Week 5 discussion for CS 101."
Agent: Calls list_discussion_topics to find the Week 5 topic, then list_discussion_entries to get all posts, then cross-references with enrolled students. Outputs a participation summary listing students who have not posted.
User: "Send them a reminder."
Agent: Drafts a reminder message referencing the discussion deadline, shows it for confirmation, then calls send_conversation to message the non-participating students.
User (student): "I need to reply to Maria's post in the Case Study discussion."
Agent: Calls list_discussion_topics to find the Case Study topic, then list_discussion_entries to locate Maria's post, then get_discussion_entry_details to read the full content. Helps draft a reply that references Maria's key arguments, shows the draft for confirmation, then calls reply_to_discussion_entry.
Notes
- This skill pairs well with
canvas-morning-checkfor educators who want a full course status before diving into discussions. - Discussion entries support HTML content. When drafting posts, use paragraph tags for readability but avoid overly complex markup.
- Canvas API permissions determine what each user can do. Students cannot create discussion topics unless the course allows it. Educators have full access.
- For courses with many discussions, suggest filtering by recent or pinned topics to keep the workflow focused.
In this repository10 other files it gives its agents.
- AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- docs/llms.txtllms.txt
- canvas-accessibility-auditorSkill
- canvas-bulk-gradingSkill
- canvas-course-builderSkill
- canvas-course-qcSkill
- canvas-morning-checkSkill
- canvas-peer-review-managerSkill
- canvas-week-planSkill
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

