How do I install the Course Diff skill?

Run npx skillmds@latest add dojocodinglabs/course-diff in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Course Diff safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Course Diff?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Course Diff free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Course Diff?

dojocodinglabs (@dojocodinglabs) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Course Diff by dojocodinglabs — Agent Skill

Name: Course Diff
Author: dojocodinglabs

Course Diff

Compara dos versiones de un curso (via git tags o commits), clasifica cada cambio, y reporta impacto en alumnos enrolados. Read-only — no modifica state. Use when user asks to "diff course", "compare versions", "comparar versiones", "qué cambió", "/course-diff".

File contents

Diff de Curso entre Versiones

Lee dos versiones de course.json desde git history y produce un reporte de diferencias clasificadas.

Inputs

course-slug (required)
v1 (required): versión vieja (tag git o commit, ej. v1.0.0, HEAD~5)
v2 (required): versión nueva (tag git o commit, ej. v2.0.0, HEAD)

Flujo

Paso 1 — Verificar git context

cd docs/instructional-design/courses/{slug}/
git log --oneline {v1}..{v2} -- course.json

Si no hay diff, mensaje al usuario "No hay cambios entre {v1} y {v2} en course.json".

Paso 2 — Extraer ambas versiones

git show {v1}:docs/instructional-design/courses/{slug}/course.json > /tmp/course-{v1}.json
git show {v2}:docs/instructional-design/courses/{slug}/course.json > /tmp/course-{v2}.json

Paso 3 — Despachar changelog-generator

Despachar ${CLAUDE_PLUGIN_ROOT}/agents/changelog-generator.md con ambos paths.

Recibir:

Classification global (major/minor/patch)
Lista de cambios clasificados individualmente
Impact analysis si MAJOR

Paso 4 — Detectar ID stability violations

Si el agent reporta ID changes inmutables: marcarlos como ERRORS críticos en el reporte (no solo "BREAKING" — son inválidos en el modelo cmi5).

Paso 5 — Generate diff-report.md

docs/instructional-design/courses/{slug}/diffs/diff-{v1}-to-{v2}.md:

# Course Diff: {course} {v1} → {v2}
**Generated**: {date}
**Classification**: MAJOR | MINOR | PATCH | NO_CHANGE

## Changes

### Removed
- ...

### Changed
- ...

### Added
- ...

## ID Stability Errors (críticos si presentes)
- {if any}: estos IDs no debieron cambiar — rompen historial xAPI

## Impact Analysis (solo si MAJOR)
- N alumnos enrolados podrían verse afectados
- Migration path sugerido: ...

Sin gates — read-only, idempotente. Mostrar el path generado al usuario al final.

Recursos

${CLAUDE_PLUGIN_ROOT}/agents/changelog-generator.md
${CLAUDE_PLUGIN_ROOT}/references/course-iteration-guide.md

---name: course-diffdescription: Compara dos versiones de un curso (via git tags o commits), clasifica cada cambio, y reporta impacto en alumnos enrolados. Read-only — no modifica state. Use when user asks to "diff course", "compare versions", "comparar versiones", "qué cambió", "/course-diff".---# Diff de Curso entre VersionesLee dos versiones de `course.json` desde git history y produce un reporte dediferencias clasificadas.## Inputs- `course-slug` (required)- `v1` (required): versión vieja (tag git o commit, ej. `v1.0.0`, `HEAD~5`)- `v2` (required): versión nueva (tag git o commit, ej. `v2.0.0`, `HEAD`)## Flujo### Paso 1 — Verificar git context```bashcd docs/instructional-design/courses/{slug}/git log --oneline {v1}..{v2} -- course.json```Si no hay diff, mensaje al usuario "No hay cambios entre {v1} y {v2} en course.json".### Paso 2 — Extraer ambas versiones```bashgit show {v1}:docs/instructional-design/courses/{slug}/course.json > /tmp/course-{v1}.jsongit show {v2}:docs/instructional-design/courses/{slug}/course.json > /tmp/course-{v2}.json```### Paso 3 — Despachar changelog-generatorDespachar `${CLAUDE_PLUGIN_ROOT}/agents/changelog-generator.md` con ambos paths.Recibir:- Classification global (major/minor/patch)- Lista de cambios clasificados individualmente- Impact analysis si MAJOR### Paso 4 — Detectar ID stability violationsSi el agent reporta ID changes inmutables: marcarlos como **ERRORS** críticos enel reporte (no solo "BREAKING" — son inválidos en el modelo cmi5).### Paso 5 — Generate diff-report.md`docs/instructional-design/courses/{slug}/diffs/diff-{v1}-to-{v2}.md`:```markdown# Course Diff: {course} {v1} → {v2}**Generated**: {date}**Classification**: MAJOR | MINOR | PATCH | NO_CHANGE## Changes### Removed- ...### Changed- ...### Added- ...## ID Stability Errors (críticos si presentes)- {if any}: estos IDs no debieron cambiar — rompen historial xAPI## Impact Analysis (solo si MAJOR)- N alumnos enrolados podrían verse afectados- Migration path sugerido: ...```Sin gates — read-only, idempotente. Mostrar el path generado al usuario al final.## Recursos- `${CLAUDE_PLUGIN_ROOT}/agents/changelog-generator.md`- `${CLAUDE_PLUGIN_ROOT}/references/course-iteration-guide.md`

Frequently asked questions