moodle-dev

The most complete Moodle development toolkit for AI coding assistants — skills, slash commands, and subagents that turn your assistant into a Moodle expert. Native plugin for Claude Code; ships with adapters for Cursor, GitHub Copilot, Aider, Continue, and a paste-anywhere bundle.

Scaffolds plugins, writes XMLDB upgrades, audits privacy/security, generates PHPUnit + Behat tests, builds AMD modules, reviews PRs — all following official Moodle coding standards (PSR-4, frankenstyle, MOODLE_INTERNAL, GPL headers, get_string, $DB).

🔌 Companion MCP server: moodle-mcp — live moodledev.io documentation search inside Claude Desktop / Code, Cursor, Continue, Cline. pipx install moodle-mcp.

Why this plugin

Claude already knows PHP. It does not know:

• Moodle's frankenstyle conventions (local_<name>, mod_<name>, block_<name>, ...)
• XMLDB editor workflow + upgrade_plugin_savepoint rules
• Privacy API contracts (null_provider vs request\plugin\provider)
• Capability + sesskey + require_login security pattern
• Moodle 4.4+ Hooks API vs legacy lib.php callbacks
• pluginfile.php file-serving callback
• Behat + PHPUnit Moodle harness (resetAfterTest, generators, tags)
• AMD/RequireJS + grunt build
• Mobile app remote templates + get_remote_addons

This plugin teaches Claude all of it. Auto-activates when Claude detects Moodle work.

Install

Claude Code (native plugin)

/plugin marketplace add https://github.com/SaadRahman01/claude-moodle-dev
/plugin install moodle-dev@moodle-dev

(If git@github.com SSH auth fails, use the full https:// URL as shown above.)

Local dev: /plugin marketplace add /absolute/path/to/claude-moodle-dev. Verify: /plugin list.

One-liner installer (any non-Claude assistant)

./install.sh <cursor|copilot|aider|continue|generic> [--dest <path>]

Defaults to current directory. Or copy manually as below.

Cursor

Copy adapters/cursor/.cursor/ into your project (or ~/.cursor/ for global use). Each skill becomes an on-demand rule; agents and commands surface via @<name> mentions in chat.

GitHub Copilot

Copy adapters/copilot/.github/ into your repo. copilot-instructions.md is applied to every chat in the repo; per-skill chatmodes appear in the chat-mode picker.

Aider

Drop adapters/aider/CONVENTIONS.md into your project root and add it to .aider.conf.yml:

read:
  - CONVENTIONS.md

Load individual skills on demand with /read-only adapters/aider/skills/<name>.md.

Continue.dev

Copy adapters/continue/ into ~/.continue/ (merge with existing config.yaml). Skills load as rules; commands appear as slash prompts.

Any other assistant

Paste relevant sections from adapters/generic/PROMPTS.md — it's one self-contained markdown file with every skill, agent, and command. Works with anything that takes a system prompt.

Companion MCP server: live Moodle docs

moodle-mcp is a separate Model Context Protocol server that gives any MCP-capable client (Claude Desktop / Code, Cursor, Continue, Cline, Windsurf) live access to the canonical Moodle developer documentation. The skills here teach conventions; the MCP server provides authoritative lookups.

What it adds

Plus MCP resources (moodle://docs/apis/...) and prompts (moodle-plugin-skeleton, moodle-capability-review, moodle-hooks-migration).

No API keys. Sitemap + disk cache + conditional GET. Pairs cleanly with this plugin.

Install (Claude Code)

Auto-wired when installing this plugin via marketplace. Requires uv on PATH:

brew install uv      # or: pip install uv

The plugin's mcpServers entry runs uvx --from git+https://github.com/SaadRahman01/moodle-mcp moodle-mcp on demand — no manual pipx install needed.

Manual install (any client):

pipx install moodle-mcp
claude mcp add moodle moodle-mcp

Other clients: see moodle-mcp README.

What's inside

Skills (auto-activate)

Slash commands

Subagents

Example: from prompt to plugin

You:

Build a local_attendance_export plugin that lets teachers export per-course attendance as CSV. Needs a capability, a settings page, and a CLI script.

Claude (with this plugin loaded) generates:

local/attendance_export/
├── version.php                            # 2026050200, requires 2024042200
├── settings.php                           # admin_setting_configtext for default delimiter
├── lib.php                                # local_attendance_export_extend_navigation()
├── cli/export.php                         # require($CFG->libdir . '/clilib.php'); cli params
├── classes/
│   ├── exporter.php                       # business logic, uses $DB
│   ├── output/renderer.php
│   └── privacy/provider.php               # null_provider (no user data stored)
├── db/
│   ├── access.php                         # local/attendance_export:export
│   └── install.xml                        # (empty — no tables)
├── lang/en/local_attendance_export.php    # pluginname, capability, settings strings
└── tests/exporter_test.php                # PHPUnit, resetAfterTest, generator

Every file follows Moodle conventions. require_capability + require_sesskey wired. PHPUnit test uses $this->getDataGenerator(). Privacy provider declared. version.php bumped correctly.

Example prompts

See EXAMPLES.md for 30+ prompts covering scaffolding, upgrades, testing, security audits, performance tuning, theme work, and mobile app integration.

Comparison

Repository layout

.claude-plugin/         # Claude Code plugin manifest
skills/                 # canonical skills (Claude reads these directly)
agents/                 # canonical subagents
commands/               # canonical slash commands

adapters/               # generated per-assistant — DO NOT hand-edit
  cursor/.cursor/rules/*.mdc
  copilot/.github/copilot-instructions.md + chatmodes/*.chatmode.md
  aider/CONVENTIONS.md + skills/ + commands/
  continue/config.yaml + rules/ + prompts/
  generic/PROMPTS.md    # paste-anywhere single-file bundle

scripts/build-adapters.py   # regenerates adapters/ from canonical files
install.sh                  # one-liner adapter installer for non-Claude assistants
tests/run.sh                # structural test harness (run before commit)
docs/ADAPTER_AUTHORING.md   # how to add a new assistant
.githooks/pre-commit        # phpcs + PHPUnit + version.php monotonicity (install: git config core.hooksPath .githooks)
.github/workflows/lint.yml     # CI: JSON, frontmatter, adapter sync, links, spellcheck, actionlint
.github/workflows/release.yml  # tag-driven release: bundle + changelog extraction + GH release
.github/CODEOWNERS          # auto-review routing
.github/dependabot.yml      # weekly GitHub Actions updates
SECURITY.md                 # vulnerability disclosure policy

Editing workflow

1. Edit canonical files under skills/, agents/, or commands/.
2. Run python3 scripts/build-adapters.py to regenerate adapters.
3. Commit both. CI fails if adapters/ drifts from canonical source.

Compatibility

PHP support: 8.1+ for Moodle 4.x, 8.2+ for 5.0/5.1, 8.3+ for 5.2. PHP 8.4 tested on 5.1+. Some skills note Moodle-version-specific differences.

Roadmap

• moodle-question-bank skill (qtype/qbank deeper coverage)
• moodle-h5p skill
• moodle-lti-tool skill (LTI 1.3 tool/provider)
• moodle-analytics skill (analytics models)
• moodle-cli-script slash command
• moodle-translation-export slash command
• MCP server wrapping moodledev.io docs search
• MCP server for live Moodle dev instance (XMLDB editor, purge caches)

Vote / request: open an issue.

Contributing

PRs welcome — see CONTRIBUTING.md. Quick path:

1. Fork
2. Add a skill: skills/<name>/SKILL.md with name + description frontmatter
3. Add a command: commands/<name>.md with frontmatter
4. Add an agent: agents/<name>.md with frontmatter
5. PR — CI lints JSON + frontmatter automatically

License

MIT — see LICENSE.

Code Claude generates with these skills should ship as GPL-3.0-or-later to be Moodle plugin directory compatible.

Credits

Built by Saad Rahman. Powered by Claude Code and the Moodle Developer Documentation.

If this saves you time, ⭐ the repo — helps others find it.