New to GitHub or open source? You are welcome here.

AI Skill Navigator maintains small and well-scoped issues for first-time contributors in PHP, JavaScript, Moodle, accessibility, documentation, translations, testing, and the Flashcards learning-tool initiative.

1. Star our repo.
2. Fork the repository.
3. Browse the open good first issue tasks.
4. Read BEGINNER_CONTRIBUTING.md.
5. Pick one issue and open your first Pull Request.

Useful links:

• Good First Issues: https://github.com/Berserk-hub150/moodle-ai-skill-navigator/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22
• Beginner guide: BEGINNER_CONTRIBUTING.md
• Flashcards area: community/flashcards/

Small beginner Pull Requests are prioritized for review.

Merged contributions are credited through GitHub contributor history.

AI Skill Navigator is a Moodle plugin suite that adds course-aware AI learning tools for students and teachers.

The package contains:

• local_aiskillnavigator: the main local plugin with AI tutor, quiz generation, mind maps, assessments, material/RAG tools, learning-gap analysis, simulator suggestions and course-building helpers.
• block_aiskillnavigator: an optional course block that links users to the tools available for their role.

The plugin is designed to install safely with conservative defaults:

• The default AI provider is prototype, which performs no external AI calls.
• External AI use for course materials is disabled until an administrator enables it.
• Per-material approval is required before teacher materials can be sent to external providers.
• Destructive AI Course Builder actions are disabled by default.
• Automatic course-resource synchronisation on Moodle events is disabled by default.
• Automatic block insertion into courses is disabled by default.
• External MathJax CDN loading is disabled by default.

Administrators can enable optional external services from the plugin settings.

• Course-aware AI Tutor.
• AI Quiz Generator.
• AI Mind Map Generator.
• Initial and final assessments.
• Adaptive review for weak skills.
• Teacher dashboard and tutor analytics.
• Course Materials / RAG management.
• Learning-gap analysis.
• AI Course Builder with production safety gates.
• Simulator Finder and saved simulation activities.

Install the local plugin in:

local/aiskillnavigator

Install the optional block in:

blocks/aiskillnavigator

Then visit:

Site administration > Notifications

Open:

Site administration > Plugins > Local plugins > AI Skill Navigator

Important production settings:

• Provider: keep prototype for first installation checks.
• Approve external AI for teacher materials: disabled by default.
• Allow destructive AI Course Builder actions: disabled by default.
• Automatically sync course resources on Moodle events: disabled by default.
• Automatically add the AI Skill Navigator block to courses: disabled by default.
• Enable external MathJax CDN: disabled by default.

The plugin stores course materials, quiz attempts, assessment attempts, saved simulations and tutor interaction signals. It implements Moodle's Privacy API for metadata, export and deletion of user data. External AI providers are optional and disabled for course materials unless explicitly approved.

• Moodle 4.4 or later.
• PHP version supported by the target Moodle version.
• Optional cURL support for external AI/search providers.

The repository includes automated checks for PHP 8.1–8.3, XMLDB parsing, JavaScript syntax, UTF-8 BOM regressions, RAG API compatibility, and safe embedding defaults. See CONTRIBUTING.md for the local commands and docs/manual-test-checklist.md for Moodle runtime scenarios.

For a Moodle installation package, place plugins/aiskillnavigator at local/aiskillnavigator and plugins/block_aiskillnavigator at blocks/aiskillnavigator. Do not package the repository root as a single Moodle plugin directory.

GPL v3 or later.