dsh-plugin-education

dsh-plugin-education

An education toolkit for DeepSeek Harness agents: lesson-plan skeletons, quiz validation, rubrics, flashcards, and readability levels. The model authors the content; the plugin supplies structure and checks.

Compatibility

Tool schemas are validated against the @deepseek-ai/dsh-tools value-schema DSL at plugin load (checked against dsh-tools 0.1.0-rc.6 and 0.1.1-rc.2). Earlier releases used JSON-Schema required at the root of output.schema and closed nested objects without declared properties, which made the host abort the whole profile boot with unsupported JSON schema: schema.required is not supported by the value schema DSL and could reject the tool's own results. Current releases fix both; if an affected version left your DSH unable to start, remove the plugin from the profile (or upgrade) — no data is lost.

Install

dsh plugin --profile <profile> add dsh-plugin-education

Restart DSH. The edu_kit tool is registered host-wide.

Tool

action	purpose
lesson	Lesson-plan skeleton by grade band (primary / secondary / tertiary / adult) with a minute budget
quiz	Validate quiz items — stem, ≥2 unique options, answer index in range, explanation
rubric	Analytic rubric table from criteria × levels
flashcard	Convert Q/A pairs to Anki TSV or markdown
level	Readability — Flesch for English, CJK length heuristics for Chinese
grade	Grading sheet from scored items — totals, percentage, letter grade, pass/fail
studyplan	Weekly study plan from a date range and topic hour budgets
question	Question skeletons by type (single/multiple/fill/short) and difficulty
classstats	Class score statistics — mean, median, stdev, pass rate, score bands

Config

All optional, on the composition row's config:

key	default	meaning
personaSection	true	register the education prompt-guidance section
sectionOrder	6	prompt section order (persona is 0, ascending)

Design

Pure logic (lib/education.js) has zero DSH/Cordis imports and is unit-tested in isolation; lib/index.js is the thin Cordis plugin wiring the tool and the prompt section. No filesystem access — deterministic and side-effect free.

License

MIT

Roadmap

See ROADMAP.md — next five versions (v0.2.0 – v0.6.0): grading & study plans, question scaffolding & class stats, lesson variants & activities, standards alignment & reports, paper assembly & learning paths.