kp-quality-review

Name: kp-quality-review
Author: Tibsfox/gsd-skill-creator

$npx mdskill add Tibsfox/gsd-skill-creator/kp-quality-review

Reviews knowledge pack quality for educational accuracy and compliance.

Ensures content is factually correct, age-appropriate, and culturally sensitive.
Depends on pack metadata files like vision.md and .skillmeta.
Assesses grade-level fit, accessibility, learning coherence, and assessment alignment.
Outputs a quality report with pass/fail status and improvement suggestions.

SKILL.md

.github/skills/kp-quality-reviewView on GitHub ↗

---
name: kp-quality-review
description: "Reviews knowledge pack quality: educational accuracy, grade-level appropriateness, accessibility compliance, learning pathway coherence, assessment alignment, and parallel instruction pattern conformance. Use when reviewing pack content after validation."
metadata:
  extensions:
    gsd-skill-creator:
      triggers:
        intents:
          - "pack.*review"
          - "pack.*quality"
          - "education.*review"
          - "accessibility.*check"
        files:
          - "src/knowledge/packs/**/.skillmeta"
          - "src/knowledge/packs/**/vision.md"
        contexts:
          - "pack quality review"
          - "educational review"
        threshold: 0.7
      token_budget: "1.0%"
      version: 1
      enabled: true
      plan_origin: "244-chipset-agent-definitions"
      phase_origin: "244"
---

# Quality Review

## Purpose

Reviews pack content for educational quality beyond schema compliance. The KP-06 reviewer agent uses this skill to assess educational accuracy, grade-level appropriateness, accessibility compliance, learning pathway coherence, and assessment alignment with stated learning outcomes. Also verifies that parallel instruction patterns (NFR-06) are consistently applied across packs for token caching optimization.

## Capabilities

- Educational accuracy review: content factually correct, age-appropriate, culturally sensitive
- Grade-level appropriateness: activities match stated grade ranges, complexity scales properly
- Accessibility compliance: .skillmeta includes accessibility metadata fields, content is screen-reader-friendly
- Learning pathway coherence: module prerequisites form a valid DAG, pathways cover all learning styles
- Assessment alignment: rubric criteria map to stated learning outcomes, formative/summative balance
- Parallel instruction pattern conformance: packs use shared template structure for caching (NFR-06)
- Cross-pack consistency: similar subjects use consistent terminology, formatting, and structure
- Content completeness: vision docs cover all required sections, activities span all grade levels

## Review Checklist

1. Vision document has Vision, Problem Statement, Core Concepts, Modules, Assessment, Parent Guidance sections
2. Modules YAML has correct prerequisite ordering (no forward references within pack)
3. Activities span at least 3 of 5 learning pathways (Maker, Academic, Curiosity, Social, Parent-Guided)
4. Assessment rubric has all 4 levels (Beginning, Developing, Proficient, Advanced)
5. Resources are categorized by audience and include at least 3 categories
6. .skillmeta grade_levels cover Foundation through at least High School
7. Parallel instruction patterns are followed (shared sections use template format)
8. Accessibility stubs present in .skillmeta
9. Translation stubs present in .skillmeta

## Dependencies

- kp-content-validation skill must pass first (validator is the gate)
- Pack runtime API for structured access to pack content

## Token Budget Rationale

1.0% budget covers the review methodology, checklist, and quality criteria. The reviewer reads pack content but does not hold validation engine internals, keeping context focused on quality dimensions.

More from Tibsfox/gsd-skill-creator

Skill	Description
3d-interaction-design	Design heuristics for three-dimensional interaction — input modalities (6DoF controllers, gaze, gesture, voice), selection and manipulation techniques (ray-cast, virtual hand, go-go, world-in-miniature), navigation (teleport, continuous, redirected walking), and feedback loops (haptic, audio, visual). Covers Fitts' law in 3D, discoverability vs affordance, safe-zone design, and comfort/simulator sickness mitigation. Use when designing VR/AR interactions, immersive walkthroughs, or any input system where the user's body is the controller.
accessibility-patterns	Provides web accessibility best practices for semantic HTML, ARIA, keyboard navigation, color contrast, and screen reader patterns. Use when building UI components, reviewing accessibility, or when user mentions 'a11y', 'accessibility', 'ARIA', 'screen reader', 'keyboard navigation', 'WCAG'.
active-listening	Active listening techniques for effective communication. Covers attending behaviors, paraphrasing, reflective listening, clarifying questions, empathic response, barriers to listening, listening in conflict, and cross-cultural listening. Use when building listening skills, improving understanding in conversation, mediating disputes, or analyzing communication breakdowns.
adversarial-pr-review	Adversarial spec-compliance PR review — cross-references diffs against approved specs, verifies runtime claims against source, detects competing PRs, audits scope/convention compliance. Use before merging.
agile-methods	Agile and Lean software development methodologies for iterative, adaptive project execution. Covers Scrum (roles, ceremonies, artifacts), Kanban (WIP limits, flow metrics), XP (TDD, pair programming, CI), SAFe overview, Lean Software Development (Poppendieck's 7 principles), user stories (INVEST criteria), estimation via story points and velocity, and the Agile Manifesto's values and principles. Includes Cynefin framework for methodology selection and GSD's relationship to Agile as a structured Lean variant.
algebraic-reasoning	Symbolic manipulation, equation solving, and algebraic structures for mathematical reasoning. Covers distributive law, factoring, completing the square, linear through polynomial equation solving, systems of equations (substitution, elimination, Gaussian elimination, matrix methods), algebraic structures (groups, rings, fields), modular arithmetic, polynomial theory, and inequalities. Use when solving equations, simplifying expressions, working with algebraic structures, or performing symbolic manipulation.
algorithmic-awareness	Understanding how algorithmic systems shape what users see, know, and do -- from recommendation feeds to search ranking to credit scoring to hiring software. Covers the mechanics of recommendation systems, algorithmic bias and its sources, personalization's effects on information diets, opacity and accountability, AI limitations (hallucination, confident wrongness), and the human-in-the-loop question. Use when a learner needs to think critically about why particular content reached them.
algorithms-data-structures	Algorithms and data structures from first principles through advanced analysis. Covers sorting (bubble, insertion, selection, merge, quick, heap, radix), searching (linear, binary, BFS, DFS, Dijkstra, A*), fundamental data structures (arrays, linked lists, stacks, queues, hash tables, trees, heaps, graphs, tries), complexity analysis (Big-O, Big-Omega, Big-Theta, amortized), recurrence relations, and algorithm design paradigms (divide-and-conquer, greedy, dynamic programming, backtracking). Use when analyzing, selecting, implementing, or comparing algorithms and data structures.
aminet-browser	Aminet search and browse: full-text search, category tree navigation, architecture filtering, package detail, and curated collections. Use when searching, browsing, or managing package collections.
aminet-emulator	FS-UAE emulator configuration and launch: hardware profiles, ROM management, WHDLoad integration, config generation, and state snapshots. Use when configuring emulation, managing ROMs, or launching Amiga software.