SkillOpt-Sleep — DeepSeek Harness (dsh) integration
Give your DeepSeek Harness agent a nightly sleep cycle: it reviews past sessions offline, replays your recurring tasks on your own API budget, and consolidates what it learns into validated skills behind a held-out gate. Same engine as the Claude Code / Codex / Cursor integrations (skillopt_sleep), wired into dsh's plugin system as native tools plus a bundled skill.
DeepSeek Harness is the "everything is a plugin" agent framework (deepseek-ai/deepseek-harness). Plugins are TypeScript modules exporting an apply(ctx) function that register capabilities (tools, services, events, settings) on the Cordis context.
Why a sleep cycle?
Skills improve when an agent re-examines its own sessions — not just when you hand-tune a prompt. The sleep cycle turns your everyday usage into a nightly, validation-gated skill-improvement loop: harvest what you actually did, replay the recurring tasks on your own API budget, and keep only the changes that pass a held-out gate. It's the same engine as the Claude Code / Codex / Cursor integrations, wired into dsh as native tools plus a bundled skill.
What this integration adds
| Component | Purpose |
|---|---|
src/index.js | dsh plugin entry: registers 7 skillopt_* tools + Schemastery config |
cordis.patch.yml | bundle patch layer — drop dsh-skillopt into any profile's bundles |
skills/skillopt-sleep/SKILL.md | agent skill: when to use the tools, operating rules, data-boundary rules |
scripts/sleep.py | bootstrap/self-check runner (same command shape the tools use) |
package.json | npm package metadata (bundle manifest) |
Tools
| Tool | skillopt_sleep action | Behavior |
|---|---|---|
skillopt_status | status | state, engine availability, latest staged proposal & report |
skillopt_dry_run | dry-run | full preview (harvest+mine+replay), stages nothing |
skillopt_run | run | full cycle, stages a proposal (live files unchanged) |
skillopt_adopt | adopt | apply latest staged proposal (with backup) — the live-change boundary |
skillopt_harvest | harvest | read-only show/export of mined tasks |
skillopt_schedule / skillopt_unschedule | schedule / unschedule | install/remove the nightly cron entry |
Prerequisites
- DeepSeek Harness (dsh) installed
- Python 3.10+ with the SkillOpt-Sleep engine:
pip install skillopt # or use this source checkoutInstall
As a bundle in a profile
Add dsh-skillopt to the profile's bundles, or in the profile cordis.patch.yml:
- insert:
- id: skillopt
name: './src/index.js'
config:
backend: mock # or codex / claude / cursor / pi / opencode / handoff …
project: /path/to/project
preferences: 'Always use async/await'Local patch overlay (dev)
Run from a DeepSeek Harness source checkout (the official dev workflow, pnpm resolves the workspace dsh bin):
pnpm dsh web --patch ./plugins/dsh/cordis.patch.ymlIf dsh is installed globally (npm install -g), use it directly:
dsh web --patch ./plugins/dsh/cordis.patch.ymlEither way the patch inserts the skillopt plugin row into the profile; then ask the agent: "Use skillopt_status to check the sleep cycle state."
Config keys
| Key | Default | Purpose | ||||||||
|---|---|---|---|---|---|---|---|---|---|---|
pythonCmd | python | Python interpreter for the engine | ||||||||
module | — (bootstrap) | engine Python module override (python -m <module>) | ||||||||
engineScript | — (scripts/sleep.py) | engine bootstrap script override | ||||||||
project | — | default project directory | ||||||||
scope | — | harvest scope: all \ | invoked | |||||||
backend | — | `mock\ | claude\ | codex\ | copilot\ | cursor\ | pi\ | opencode\ | handoff\ | azure_openai` |
source | — | `claude\ | codex\ | copilot\ | cursor\ | pi\ | opencode\ | auto` | ||
model | — | backend model override | ||||||||
maxTasks / maxSessions | — | mine/harvest caps | ||||||||
editBudget | — | bounded edits per cycle | ||||||||
preferences | — | house rules for the reflection prior | ||||||||
jsonOutput | false | machine-readable JSON output | ||||||||
autoAdopt | false | OPERATOR-ONLY: auto-adopt a passed proposal without asking | ||||||||
unscheduleAll | false | OPERATOR-ONLY: allow skillopt_unschedule to remove every managed entry | ||||||||
timeoutMs | 600000 | per-call engine timeout in milliseconds |
Advanced engine keys (gate_mode, gate_metric, gate_no_regression, dream_rollouts, recall_k, evolve_memory/evolve_skill) go in ~/.skillopt-sleep/config.json — the same file shared by all integrations.
Data boundary
- Harvest is read-only;
mock/handoffmake no network calls. runstages proposals;adoptis the normal live-change boundary and backs up first.- Real backends send truncated transcript excerpts and derived tasks to the
selected provider. For sensitive sessions, export tasks first (skillopt_harvest with output=), redact, set "reviewed": true, then replay — real backends refuse unreviewed task files.
- Outbound prompts are not guaranteed secret-free; review source & provider policy.
Validate (no API spend)
python -m skillopt_sleep.experiments.run_experiment --persona researcher --assert-improvesSee the SkillOpt-Sleep documentation for recorded results, limitations, and the supported integration surface.
