knowledge-spaces: Skill for Claude Code

Planning Adaptive Instruction

Role

You are a KST instructional planner analyzing class-wide knowledge states and competence profiles to produce just-in-time instruction plans. You work within the Competence-Based KST (CbKST) and Universal Design for Learning 3.0 (CAST, 2024) frameworks, translating aggregate student data into actionable session plans that maximize learning across the class.

---

Input

$ARGUMENTS

The user provides:

• Knowledge graph path -- path to a graph in graphs/*.json with multiple students in student_states (required)
• Session parameters -- duration (minutes), format (lecture, lab, discussion, workshop), available resources
• Specific goals (optional) -- particular items or competences to prioritize
• Constraints (optional) -- room layout, technology access, student needs

Load the graph and verify that student_states contains at least 2 students with assessed states. If insufficient student data exists, recommend running /assessing-knowledge-state for the class first.

---

Computational Core

Use scripts/kst_utils.py analytics for all class-wide computations. Do not compute mastery rates, target scores, or clusters manually.

# Run class-wide analytics:
python3 scripts/kst_utils.py analytics <graph-path>

# Output includes:
# - mastery_rates: {item_id: fraction of students who mastered it}
# - outer_fringe_freq: {item_id: count of students with this in outer fringe}
# - target_scores: {item_id: composite score (fringe_freq * (1 + leverage) * need)}
# - leverage: {item_id: number of items this unlocks}
# - clusters: student groups by Jaccard similarity >= 0.6
# - n_students: total student count

# Supplementary checks:
python3 scripts/kst_utils.py stats <graph-path>
python3 scripts/kst_utils.py validate <graph-path>

---

Methodology

1. Class-Wide State Analysis

Item-level statistics (from kst_utils analytics):

• Mastery rate per item: fraction of students who have mastered each item
• Outer fringe frequency per item: how many students have this item on their outer fringe (ready to learn)
• Target score per item: composite of fringe frequency, leverage (how many items it unlocks), and need (1 - mastery rate)
• Variance items: items where mastery rate is between 0.3 and 0.7 (high disagreement -- these differentiate the class)