@@ -100,16 +100,18 @@ pip install skillopt # installs the engine + the `skillopt-sleep` command
100100skillopt-sleep dry-run # harvest + mine + replay, report only; stages nothing
101101skillopt-sleep run # a full nightly cycle; the proposal is staged for review
102102skillopt-sleep status # show state + the latest staged proposal
103- skillopt-sleep adopt # apply the latest staged proposal
103+ skillopt-sleep adopt --legacy # apply a reviewed managed proposal
104+ skillopt-sleep adopt --skill NAME # adopt one staged skill (repeatable)
105+ skillopt-sleep adopt --all-skills # adopt every still-pending fan-out skill
104106skillopt-sleep schedule # install a nightly cron entry for this project
105107```
106108
107109> ** Version note.** This page tracks ` main ` . PyPI 0.2.0 provides the base
108110> commands above. Cursor source/backend/plugin support, VS Code Copilot
109111> transcript harvesting, Pi source/backend support, Sleep handoff, non-Azure
110112> OpenAI-compatible endpoints, OpenCode Sleep source/backend support, and
111- > ` --preferences ` landed later and require a source install from ` main ` until
112- > the next release.
113+ > ` --preferences ` , multi-skill fan-out, and reviewed subset adoption landed
114+ > later and require a source install from ` main ` until the next release.
113115
114116The per-agent integrations below still come from the repo; the CLI above is the
115117standalone, pip-only way to run a cycle. Claude Code, Codex, Cursor, Copilot, and
@@ -292,22 +294,38 @@ documents the separate HTTPS-only boundary for Azure managed-identity credential
292294Deterministic proof (no API key):
293295` python -m skillopt_sleep.experiments.run_experiment --persona researcher --assert-improves ` .
294296
295- ### Opt-in: per-skill group reporting
297+ ### Opt-in: per-skill fan-out
296298
297- Set ` "multi_skill_report ": true ` in ` ~/.skillopt-sleep/config.json ` to add an
298- independent gate result and report row for every explicit skill hint mined that
299- night:
299+ Set ` "multi_skill_fanout ": true ` in ` ~/.skillopt-sleep/config.json ` to add an
300+ independent gate result and reviewable proposal for every explicit skill hint
301+ mined that night. ` multi_skill_report ` remains a compatibility alias :
300302
301303``` json
302- {"multi_skill_report " : true }
304+ {"multi_skill_fanout " : true }
303305```
304306
305307This runs one additional consolidation per group (including a catch-all group when
306- hinted and unhinted evidence are mixed), so it increases backend calls and token use.
307- It is reporting-only for now: every group starts from the same managed skill
308- document, and Sleep does not yet resolve and update several live ` SKILL.md ` files
309- automatically. Nights containing only the managed catch-all group keep the existing
310- single-consolidation behavior.
308+ hinted and unhinted evidence are mixed), so it multiplies backend calls and token
309+ use; configured dream rollouts and synthetic variants multiply the per-group work
310+ too. Each group inherits the configured edit budget, gate mode/metric,
311+ ` gate_no_regression ` , ` dream_rollouts ` , ` dream_factor ` , ` recall_k ` , and
312+ ` evolve_skill ` . Recalled archive tasks are restricted to that same skill hint;
313+ shared memory is read-only in fan-out runs. Setting ` evolve_skill ` to ` false `
314+ therefore disables per-skill proposals as well as the managed skill proposal.
315+
316+ Each explicitly hinted group resolves and reads its own live ` SKILL.md ` before
317+ consolidation, so its staged proposal preserves that skill's baseline. Missing,
318+ ambiguous, unreadable, aliased, or colliding skills are skipped and reported
319+ instead of falling back to the managed document. Adoption remains review-driven:
320+ choose fan-out proposals with ` adopt --skill NAME ` or ` --all-skills ` , and use
321+ ` adopt --legacy ` for a co-staged managed skill/memory pair. ` auto_adopt ` never
322+ promotes the per-skill fan-out. Nights containing only the managed catch-all group
323+ keep the existing single-consolidation behavior.
324+
325+ Resolution searches existing project-native ` .agents/skills ` , ` .claude/skills ` ,
326+ ` .cursor/skills ` , and ` .devin/skills ` directories, then the established Claude
327+ home and plugin-cache roots. Add repeatable ` --skill-root PATH ` values when an
328+ integration stores skills elsewhere. Relative roots resolve below ` --project ` .
311329
312330### Opt-in: experience replay & dream rollouts
313331
@@ -363,6 +381,13 @@ gate keeps the worst case bounded; keep it **on** by default.
363381
364382## Learn more
365383
384+ The ** low-level** API for staging one proposal per skill and adopting a reviewed
385+ subset (` staged_skills ` / ` adopt_skills ` , plus ` status ` and ` adopt --skill ` ) is
386+ documented in [ ` docs/sleep/multi-skill-staging.md ` ] ( multi-skill-staging.md ) .
387+ That page also documents the opt-in nightly fan-out, where every hinted group
388+ derives its proposal from its own resolved live ` SKILL.md ` while adoption remains
389+ an explicit human decision.
390+
366391See the [ SkillOpt documentation index] ( ../index.md ) , the
367392[ CLI reference] ( ../reference/cli.md ) , and the integration-specific READMEs under
368393[ ` plugins/ ` ] ( https://github.com/microsoft/SkillOpt/tree/main/plugins ) .
0 commit comments