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.