courses

Identify deprecated Cypher syntax in code files.

Create linear issues for the GRAC (GraphAcademy) team.

Periodically review course content for accuracy, relevance, and consistency. This includes checking for deprecated Cypher syntax.

Fact-check a single lesson against Neo4j documentation using the neo4j-docs MCP. Fixes inaccurate claims inline and appends a WHY report.

Review a single lesson for US English grammar, style, voice, and Neo4j terminology. Fixes issues inline and appends a WHY report.

Review a single lesson for pedagogical structure, lesson length, opening pattern, concept delivery, and scaffolding. Fixes issues inline and appends a WHY report.

Review a single lesson for AsciiDoc syntax, link formatting, code blocks, slides structure, and question includes. Fixes issues inline and appends a WHY report.

Analyse manual corrections made to lesson files during review, extract the WHY and WHAT, and append generalizable rules to the appropriate review skill. Run after any manual editing session where you caught something the automated review missed.

Write concept/theory lessons for workshops

Post inline GitHub PR review suggestions from modified .adoc files. Detects changes made by a review skill, converts each diff hunk into a one-click GitHub suggestion comment, posts them as a single PR review, then restores the working directory.

Orchestrate the full lesson review pipeline across all lessons in a course. Runs grammar, structure, technical, facts, and questions reviews on one lesson at a time — pausing between lessons for human review.

Review course-level structure and metadata — lesson attributes, module organisation, course.adoc completeness, and last-lesson requirements. Run once per course before publishing.

Review all question files in a lesson's questions/ folder. Checks titles, question text, answer options, hints, and solutions. Fixes issues inline and appends a WHY report.

Subject matter expert (SME) review of a course. The SME is opinionated, defensive about the product being taught, and deeply invested in learner success. Use when you want to audit a course for end-to-end coverage of a product or library's API and feature surface, incorrect or misleading claims about the product, unstated or incorrect prerequisites, and assumptions that would leave the learner stranded after the course ends. The SME does NOT check grammar, AsciiDoc formatting, or pedagogy — those are handled by other review skills. Input: path to a course folder (e.g. asciidoc/courses/my-course/).

Review workshop content for grammar and formatting

Write workshop and module overviews

Write knowledge check quizzes

Write validation/query lessons with SQL comparisons

Plan workshop structure from existing courses, extract topics, and create outline. Use when user wants to create a new workshop.

Write hands-on challenge lessons with verification

Write optional practice lessons with query exercises

Orchestrate creation of workshop lesson content

Review workshop content for pedagogical effectiveness

Review workshop content for technical accuracy