SkillOpt-Sleep

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 checkout

Install

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.yml

If dsh is installed globally (npm install -g), use it directly:

dsh web --patch ./plugins/dsh/cordis.patch.yml

Either 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/handoff make no network calls.
• run stages proposals; adopt is 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-improves

See the SkillOpt-Sleep documentation for recorded results, limitations, and the supported integration surface.