DeepSeek Harness Plugin

bortpro/dsh-plugin-socratic-tutor

Stars ★ 0 Category Tools & Capabilities Added 2026-11-20

Socratic tutor with topic-specific curricula, diagnostic questions, a saved skill map, spaced review, and a final assessment.

Install

# from a prebuilt release tarball

dsh plugin --profile web add "https://github.com/bortpro/dsh-plugin-socratic-tutor/releases/download/v1.0.0/dsh-plugin-socratic-tutor-1.0.0.tgz"

# from GitHub (first run asks for allowBuilds approval — follow the hint, retry)

dsh plugin --profile web add github:bortpro/dsh-plugin-socratic-tutor

Any plugin you install runs third-party code with your own permissions — it can read your files, use your credentials, and reach the network, and tool approvals don’t sandbox it. GitHub-sourced plugins also run build scripts at install time — pnpm blocks those until you allow them, so an install can stop with ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED or ERR_PNPM_IGNORED_BUILDS; dsh prints the exact key to add under allowBuilds in your profile’s pnpm-workspace.yaml, and the install works on the next run. Allowing a build is a trust decision: only install sources you trust, and pin a commit (github:owner/repo#sha).

README

Socratic Tutor runs an ongoing lesson in a DeepSeek Harness conversation. It builds a curriculum from the topic, asks one question at a time, tracks evidence against a 0–5 skill scale, and uses spaced review and a final assessment.

Install

Use DeepSeek Harness 0.2.2-rc.5, Node.js 24.9.0 or later, and pnpm on your path.

dsh plugin --profile web add https://github.com/bortpro/dsh-plugin-socratic-tutor/releases/download/v1.0.0/dsh-plugin-socratic-tutor-1.0.0.tgz
dsh --profile web

To build and install from a local checkout:

npm ci
npm pack
dsh plugin --profile web add ./dsh-plugin-socratic-tutor-1.0.0.tgz
dsh --profile web

The package declares its profile layer through dsh.bundle.patch. Harness bundle documentation

Use

Input Effect
/tutor <topic> Start a lesson for the current conversation and ask the first diagnostic question.
/tutor <topic> --full-mastery Require level 5 in every skill before the final assessment.
/progress or show progress Display the skill map.
/tutor-save or save state Return a portable JSON snapshot.
/tutor stop Pause the current lesson and keep its progress.
/tutor resume Resume the lesson saved for the current conversation.
/tutor resume <saved JSON> or resume from: <saved JSON> Restore a portable snapshot in this conversation.

You can also start with Teach me linear algebra, Quiz me on SQL joins, or Help me master fractions. Requests such as Help me understand fractions prompt for confirmation when no lesson is active. Standalone queries such as What is covariance? follow the ordinary chat route. During a lesson, type harder, easier, or just tell me to change how the tutor handles the current question.

The Cordis configuration field defaultTargetLevel accepts integers from 1 to 5 and defaults to 4. Progress is written after each lesson action to a conversation-specific JSON file under .socratic-tutor/ in the current workspace. Reopening the same conversation in that workspace preserves progress across Harness restarts and model switches. Use a portable snapshot to move a lesson to another workspace or conversation. Snapshots can contain pending questions and notes on misconceptions.

Harness enforces state transitions and the evidence required to promote a level. The selected model generates the curriculum, asks the questions, and evaluates answer quality. Use a model and agent preset with tool calling enabled.

Development

npm ci
npm test

The tests use the Harness command registry, prompt assembly, and native tool executor with scripted model actions.

Content from the project README on GitHub ↗

Links

More in this category

View the whole category →

Community comments

Comments are public GitHub Discussions. Loading them connects to GitHub and Giscus; a GitHub account is required to post.