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.