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.
Links
More in this category
Tencent/WeKnora#dsh-weknora★ 37918
Four read-only tools over a WeKnora knowledge base: list knowledge bases, hybrid passage search, reassemble one document's chunks in order, and WeKnora's own cited RAG or ReAct-agent answer with a resumable session id.
DayuanJiang/next-ai-draw-io#dsh-plugin★ 37097
Draws draw.io diagrams in DeepSeek Harness through the next-ai-drawio MCP server: the link in the reply opens a live preview in the right sidebar, you can edit the diagram by hand, and each AI change is a version you can restore. Node.js 18+; npx downloads the MCP server on first use.
superdesigndev/treg★ 8650
Tool catalog for agents: search ~2,600 external endpoints (SEO and SERP, backlinks, social, people and company enrichment, ad libraries, scraping) by the task you want done, read each one's parameters and per-call price, then call it with the credential injected server-side. Ships the skill plus an MCP row that stays disabled until TREG_TOKEN is set.
T-Auto/dsh-ops★ 5964
Provides bash, PowerShell 7, and high-performance Rust tools for DSH on Windows to reduce token usage.
sixtysevenlf/dsh-blender-plugin★ 2216
Lets a DSH agent drive a local Blender over a direct TCP channel with 15 tools: viewport frames, custom-angle renders, Python execution, headless and job offload, transaction rollback, and a planning layer of 228 ops across 34 families.
helloHub1212/dsh-windows-mcp★ 2002
Bridges the CursorTouch/Windows-MCP desktop automation server into DSH through the official MCP client bridge, registering its screenshot, UI tree snapshot, mouse and keyboard input, clipboard, process and registry tools as mcp__windows__* tools for the model, and adds a windows_mcp_doctor diagnostic tool. Computer Use is off by default and is switched on from the plugin panel.
Community comments
Comments are public GitHub Discussions. Loading them connects to GitHub and Giscus; a GitHub account is required to post.