القائمة
Manage Moodle courses via CLI — create/update/delete activities, sections, quizzes, import GIFT questions, and AI-assisted essay grading. Use /moodle-skill:moodle to interact with any Moodle instance.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
| name | moodle |
| description | Manage Moodle courses via CLI — create/update/delete activities, sections, quizzes, import GIFT questions, and AI-assisted essay grading. Use /moodle-skill:moodle to interact with any Moodle instance. |
| argument-hint | [command] [args...] |
| disable-model-invocation | true |
Manage any Moodle course via the moodle-updater.js CLI. All destructive operations require a dry-run first, then explicit user confirmation before --live.
/moodle-skill:moodle, /moodle-skill:moodle structure.env in your project root with MOODLE_URL, MOODLE_SESSION, and COURSE_IDlogin command$ARGUMENTS — if arguments provided, use as command + args and proceed to Phase 2.$ARGUMENTS is empty, present the Command Reference Table below and ask which command to run.login command: Execute directly — opens a browser for authentication. The browser auto-closes once login is detected. Supports --browser msedge or --browser chrome for SSO.
Read-only commands (structure, list-activities, show-label, show-page, dump-form, dump-grading): Execute directly.
NODE_PATH="${CLAUDE_PLUGIN_DATA}/node_modules" node "${CLAUDE_PLUGIN_ROOT}/scripts/moodle-updater.js" <command> <args...>
All other commands: Execute WITHOUT --live first (dry-run is the default).
After showing the dry-run output, ask the user for confirmation before running with --live.
NODE_PATH="${CLAUDE_PLUGIN_DATA}/node_modules" node "${CLAUDE_PLUGIN_ROOT}/scripts/moodle-updater.js" <command> <args...> --live
| Group | Command | Arguments | Description |
|---|---|---|---|
| Setup | login | [--browser msedge|chrome] | Open browser, login, save cookie to .env (auto-closes) |
| Read | structure | — | Show course structure |
| Read | list-activities | <sectionId> | List activities in a section |
| Read | show-label | <moduleId> | Show label HTML |
| Read | show-page | <moduleId> | Show page HTML |
| Update | update-label | <moduleId> <htmlFile> | Replace label content |
| Update | update-page | <moduleId> <htmlFile> | Replace page content |
| Update | update-summary | <sectionId> <htmlFile> | Replace section summary |
| CRUD | create-url | <sectionNum> <name> <url> | Create URL activity |
| CRUD | create-page | <sectionNum> <name> <htmlOrMdFile> | Create text page (.md auto-converts) |
| CRUD | create-label | <sectionNum> <htmlOrMdFile> | Create label (no name field; .md auto-converts) |
| CRUD | create-resource | <sectionNum> <name> <file> | Upload file resource |
| CRUD | create-assign | <sectionNum> <name> <htmlOrMdFile> [--open ts] [--due ts] | Create assignment |
| CRUD | create-forum | <sectionNum> <name> <htmlOrMdFile> | Create forum |
| CRUD | create-quiz | <sectionNum> <configJson> | Create quiz (SEB, time limit) |
| Manage | delete-activity | <moduleId> | Delete activity |
| Manage | hide-activity | <moduleId> | Hide activity |
| Manage | indent-activity | <moduleId> | Indent activity |
| Manage | move-activity | <moduleId> <afterModuleId> | Move activity |
| Sections | add-section | — | Append a new empty section at the end |
| Sections | delete-section | <sectionId> | Delete section |
| Sections | duplicate-section | — | Duplicate last section |
| Sections | move-section | <sectionId> <targetSectionId> | Move section before target |
| Sections | rename-section | <sectionId> <title> | Rename section |
| Quiz | import-gift | <cmid> <giftFile> | Import GIFT questions |
| Quiz | add-questions-to-quiz | <cmid> [categoryName] | Assign questions to quiz |
| Quiz | delete-quiz-questions | <cmid> [categoryName] | Delete questions in category |
| Grading | grade-essay scrape | <cmid> --gift <path> [--slot N] --output <file> | Export student responses as JSON |
| Grading | grade-essay submit | <cmid> --grades <file> [--live] | Submit grades to Moodle |
| Assignment | assign-students | <cmid> [--out <path>] | List participants + submission status |
| Assignment | assign-subs | <cmid> [--all] [--user <id>] | Download submissions (online text + files) |
| Assignment | assign-grades | <cmid> [--user <id>] | Read current grade per participant |
| Assignment | assign-submit | <cmid> --from <grades.json> [--user <id>] [--live] | Write points + comments back to Moodle |
| Gradebook | gradebook | — | Show gradebook tree with item IDs + weights |
| Gradebook | gradebook-create-category | <name> [--aggregation N] [--weight N] [--live] | Create a grade category |
| Gradebook | gradebook-set-weights | <id:weight ...> [--live] | Set weight overrides (IDs from gradebook) |
| Gradebook | gradebook-move-to-category | <cmid> <categoryId> [--live] | Move an activity into a category |
| Diagnostic | dump-form | <type> <sectionNum> | Inspect form fields |
| Diagnostic | dump-grading | <cmid> [--slot N] | Inspect grading page |
The AI grading workflow is split into scrape → grade → submit:
NODE_PATH="${CLAUDE_PLUGIN_DATA}/node_modules" node "${CLAUDE_PLUGIN_ROOT}/scripts/moodle-updater.js" grade-essay scrape <cmid> --gift <path> --output grading.json
This produces a JSON file with questions (criteria, model answers) and student responses.
Read the JSON file, grade each student response against the criteria, and produce a grades JSON file.
NODE_PATH="${CLAUDE_PLUGIN_DATA}/node_modules" node "${CLAUDE_PLUGIN_ROOT}/scripts/moodle-updater.js" grade-essay submit <cmid> --grades grades-result.json --live
In addition to the moodle-updater.js CLI, the plugin ships standalone scripts to mirror a whole course locally, edit it, and append it to another course.
Reads MOODLE_URL / COURSE_ID / MOODLE_SESSION from .env and writes a round-trip-friendly tree to <outDir> (default ./kurs).
NODE_PATH="${CLAUDE_PLUGIN_DATA}/node_modules" node "${CLAUDE_PLUGIN_ROOT}/scripts/download-course.js" ./kurs
Layout produced:
kurs/
course.json, state.json, README.md
<NN>-<section-slug>/
section.json, summary.md
<MM>-<type>-<slug>/
activity.json
content.md # page/label/assign/forum/quiz/attendance bodies
files/<originalname> # for resource modules
Walks the tree and prints the equivalent moodle-updater.js commands. No HTTP calls. Uses the target MOODLE_URL / COURSE_ID from .env.
node "${CLAUDE_PLUGIN_ROOT}/scripts/upload-course.js" ./kurs
Appends each source section as a NEW section at the end of the target course — existing sections are never touched. Per source section it runs duplicate-section → rename-section → update-summary → create-<type> for each activity.
node "${CLAUDE_PLUGIN_ROOT}/scripts/execute-upload.js" ./kurs # dry run
node "${CLAUDE_PLUGIN_ROOT}/scripts/execute-upload.js" ./kurs --section 01 --live # only section 01, live
node "${CLAUDE_PLUGIN_ROOT}/scripts/execute-upload.js" ./kurs --live # all sections, live
--live is required to actually write to Moodle. Without it the script only prints the plan.
login opens a browser, user logs in, browser auto-closes once login is detected, and cookie is saved to .env. Use --browser msedge or --browser chrome for SSO.MoodleSession cookie expires after inactivity. If a command fails with a session error, run login again.structure as a quick connection test.--live without a dry-run first (except read-only commands).--live without explicit user confirmation./moodle-skill:moodle.login again.