course-auditor

Audits all courses for structural, schema, grounding, and syllabus-coverage integrity.

Updated Sep 20, 2026
One-click install
npx skills add https://github.com/alwayslistening86-pixel/claude_plugins --skill course-auditor-alwayslistening86-pixel
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: course-auditor
Source: https://github.com/alwayslistening86-pixel/claude_plugins/tree/main/generic-tutor-1.2.0/skills/course-auditor
Command: npx skills add https://github.com/alwayslistening86-pixel/claude_plugins --skill course-auditor-alwayslistening86-pixel

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Courses compiled under older plugin versions can silently break after upgrades: stage files go missing, schemas drift out of date, rubric sources stop resolving, and nobody knows whether a course actually teaches the full specification it claims to cover. This Skill performs a global maintenance sweep across every course under /EDU/courses/ to detect, report, and safely repair these integrity problems. ## Core Features & Use Cases - Structural and schema repair: Runs validate_structure.py to find missing stage files and orphaned content, and migrate_schema.py to carry old course.json and enrollment files forward to current schema versions with stated defaults. - Grounding re-verification: Re-checks that rubric sources and curriculum mappings still resolve via live web lookups, suspending unverifiable courses rather than silently patching them, and re-attempting revival on every audit. - Syllabus coverage analysis: Uses coverage_check.py to itemise each specification, map stages to the items they actually teach, and report every uncovered item by id and title before writing any changes. - Use Case: After upgrading the tutor plugin from v0.3.0 to 1.2.0, run /audit to migrate all legacy course files to schema 3 in one hop, discover that one course's rubric source no longer resolves (suspending it with a recorded reason), and receive a per-course coverage report listing exactly which specification items no stage teaches. ## Quick Start Run /audit to sweep every course under /EDU/courses/ and produce a full structural, schema, grounding, and coverage report before any fixes are applied.

Frequently Asked Questions about course-auditor

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I audit all courses after a plugin upgrade?▼

Invoke /audit to sweep every course under /EDU/courses/ regardless of enrollment status. It runs structural validation, applies schema migrations in one hop to the current version, and reports all changes before writing anything beyond Tier 1 auto-fixes.

How to check whether a course covers its full syllabus specification?▼

Run coverage_check.py on the course directory to compute a coverage status of full, partial, or unverified from curriculum_map.json. For courses never itemised, the audit re-fetches the live specification and maps each stage to the items its lesson content genuinely teaches.

What happens when a course rubric source stops resolving?▼

The course is set to grounding_status suspended_ungrounded with a suspension block recording the reason and date; it is never patched with an invented placeholder. Suspended courses do not count against the roster cap, and the audit re-attempts revival on every subsequent run.

Does the audit fix courses automatically without confirmation?▼

Only Tier 1 mechanical fixes like reattaching orphaned stage content are auto-applied. Schema migrations are auto-applied but always reported, and grounding or coverage changes require a visible report and explicit learner confirmation before writing.

How are duplicate course folders merged without losing learner progress?▼

Enrollments at 60 percent or more completion stay on the legacy copy, which is marked retiring until they finish. Enrollments below 60 percent are re-pointed to the canonical course and fully reset, while soft signals like error_patterns and confidence carry across.

Can the audit write new lessons to close a coverage gap?▼

No. The audit never writes teaching content, lessons, or test questions, and never maps an item to a stage that does not teach it. It only reports uncovered items and offers remedies such as expanding a stage lesson or adding stages through course-compiler.