skillopt-sleep

1# SkillOpt-Sleep for Cursor
2 
3SkillOpt-Sleep reviews recent local Cursor sessions, mines recurring tasks,
4replays those tasks, and proposes bounded improvements to a project Cursor
5skill. With the default gate enabled, a proposal is accepted only when it
6improves the held-out score. A normal run stages the proposal for review;
7nothing live changes until explicit adoption. There is no model-weight training.
8 
9This plugin has no session-end hook and no MCP server. Run the cycle only when
10the user asks, or install a schedule only when the user explicitly requests one.
11 
12## Cursor target
13 
14Always use this project-relative target for Cursor-visible learning:
15 
16```text
17.cursor/skills/skillopt-sleep-learned/SKILL.md
18```
19 
20Pass it through `--target-skill-path` on `harvest`, `dry-run`, and `run`.
21Without an explicit target, the shared engine uses a Claude-managed skill under
22`~/.claude/skills`, which is not the intended Cursor project skill.
23 
24The shared engine can also evolve project `CLAUDE.md`. If that secondary memory
25target is unwanted, set `"evolve_memory": false` in
26`~/.skillopt-sleep/config.json` before running.
27 
28## Choose the runner
29 
30Use one of these supported command paths consistently:
31 
321. Source checkout on macOS/Linux:
33   `bash "$SKILLOPT_SLEEP_REPO/plugins/run-sleep.sh" <action> ...`
342. Source checkout on Windows:
35   `powershell -File "$env:SKILLOPT_SLEEP_REPO\plugins\run-sleep.ps1" <action> ...`
363. Installed engine on any platform:
37   `skillopt-sleep <action> ...`
38…