Claude Code Plugins

Community-maintained marketplace

Feedback

LMS gradebook system for LT/IT (English Language Arts) and KCFS (Kang Chiao Future Skill) courses. Use this skill when implementing grade calculation, gradebook features, expectations system, or assessment title management.

Install Skill

1Download skill
2Enable skills in Claude

Open claude.ai/settings/capabilities and find the "Skills" section

3Upload to Claude

Click "Upload skill" and select the downloaded ZIP file

Note: Please verify skill by going through its instructions before using it.

SKILL.md

name lms-grades
description LMS gradebook system for LT/IT (English Language Arts) and KCFS (Kang Chiao Future Skill) courses. Use this skill when implementing grade calculation, gradebook features, expectations system, or assessment title management.

LMS Grades - Gradebook System

Quick Reference

System Score Range Formula
LT/IT 0-100 Weighted avg: FA 15%, SA 20%, Final 10%
KCFS 0-5 (→50-100) Base 50 + weighted categories

Two Calculation Engines

Engine File Final Code Use Case
Core Grade lib/grade/calculations.ts FINAL Historical reports
Formula Engine lib/gradebook/FormulaEngine.ts MID Live gradebook

LT/IT Grades (English)

Assessment Codes (14 total)

  • FA1-FA8: Formative Assessments (15% total, 0.0188 each)
  • SA1-SA4: Summative Assessments (20% total, 0.05 each)
  • FINAL/MID: Final/Midterm Exam (10%)

Formula

Semester = (FA_avg × 0.15 + SA_avg × 0.20 + FINAL × 0.10) ÷ 0.45

Rules:

  • Only scores >0 included
  • All zeros → null

→ See: references/lt-it-formula.md

KCFS Grades (Future Skills)

Formula

Term Grade = 50 + Σ(category_score × weight)

Categories by Grade

Grade Categories Weight
G1-2 COMM, COLLAB, SD, CT 2.5
G3-4 + BW (5 total) 2.0
G5-6 + PORT, PRES (6 total) 5/3

Rules:

  • Scores 0-5 (0.5 increments)
  • Zero counts (lowers grade)
  • Blank/Absent excluded

→ See: references/kcfs-formula.md

Key Files

Purpose Location
Core Calculations lib/grade/calculations.ts
KCFS Calculations lib/grade/kcfs-calculations.ts
Formula Engine lib/gradebook/FormulaEngine.ts
Gradebook Page app/(lms)/class/[classId]/gradebook/
Spreadsheet components/gradebook/Spreadsheet.tsx
Expectations components/gradebook/ExpectationsManager.tsx

Features

Gradebook Expectations (v1.52.0)

  • Head Teachers set completion targets
  • Track teacher progress by grade/course
  • Status: on_track / behind / not_started

Assessment Title Override

  • Priority: Class > Grade×Track > Default
  • Affects display only, not calculation

References