hkdse-subject-evaluation

Evaluate AI-generated HKDSE subject grades against ground-truth labels using ordinal metrics.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/AKCqhzdy/dse-subject-grading --skill hkdse-subject-evaluation
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: hkdse-subject-evaluation
Source: https://github.com/AKCqhzdy/dse-subject-grading/tree/main/.github/skills/hkdse-subject-evaluation
Command: npx skills add https://github.com/AKCqhzdy/dse-subject-grading --skill hkdse-subject-evaluation

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill evaluates HKDSE elective subject AI grading results against ground truth levels (1–5), enabling rigorous accuracy assessment and report generation.

Core Features & Use Cases

  • Ordinal evaluation: computes rank-based metrics (Spearman ρ, Kendall τ) to compare predicted levels with ground truth.
  • Ground-truth alignment: supports multiple data sources (per-student results, final scores, and optional rubric level divisions) to compute exact and adjacent match rates.
  • Comprehensive reports: generates visualization figures and DOCX evaluation reports across year scopes for subject-agnostic evaluation.

Quick Start

Execute the evaluation workflow for a given YEAR to compare grading outputs against the ground-truth mapping.

Frequently Asked Questions about hkdse-subject-evaluation

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

FAQPage Schema
How do I evaluate AI grading accuracy for HKDSE subjects against ground truth?

To evaluate AI grading accuracy for HKDSE subjects, this Skill compares predicted levels against ground-truth labels using ordinal metrics like Spearman ρ and Kendall τ. It computes exact and adjacent match rates, generates visualizations, and outputs DOCX evaluation reports.

What statistical metrics are used for ordinal grade evaluation?

Ordinal grade evaluation uses rank-based statistical metrics including Spearman ρ and Kendall τ to compare predicted grades with ground-truth levels. These metrics assess the correlation and rank order of AI-generated HKDSE subject grades.

How do I generate an evaluation report for AI-assigned HKDSE grades?

To generate an evaluation report for AI-assigned HKDSE grades, provide year-specific data and optional rubric level divisions. The workflow then computes accuracy metrics, produces visualization figures, and exports a comprehensive DOCX report.

Can I use rubric level divisions to validate AI grading results?

Yes, you can use optional rubric level divisions to validate AI grading results. The Skill aligns ground-truth data with per-student results and final scores to compute exact and adjacent match rates across the specified rubric levels.

Does the evaluation workflow support multiple years of HKDSE grading data?

The evaluation workflow supports multiple years of HKDSE grading data by applying year-specific data inputs. It processes subject-graded outputs across the specified year scope to generate comprehensive year-based evaluation reports.

What are the limitations of using rank-based metrics for subject grade evaluation?

Rank-based metrics for subject grade evaluation may not fully capture the magnitude of grading errors, only rank order. Evaluation is limited by the availability of accurate ground-truth labels and requires year-specific data for precise ordinal comparison.