Coordinate and recover multi-stage Light research projects through the canonical .light/passport.yaml state, stages 1-13, resident overlays, checkpoints, findings, parallel joins, stale propagation, handoffs and user-authorized reroutes.
SkillScore77Maintained
Automatic
◆Research pack
Last verified 8/20/2026
What it changes
Passed 15 of 19 test cases with the skill, and 6 of 19 without it.
Without skill32%
With skill77%
Checks it passed that the model alone missed
Rejects non-canonical evidence state labels
Excludes stage 12 from machine gate confirmation requirements
Keeps engineering overlay tools isolated off the scientific DAG
and 17 more in the full report
11 fixed6 passed either way4 still failing1 broke
Pass-rate lift
+45 pp
Tokens
+195%
Agent turns
0%
Response time
-43%
Model gemini-3.6-flashMeasured 8/20/2026v117 of 22 cases passed with skill · 19 comparable
Tokens, turns and time describe resource use, not a dollar price.
See it in action
One of 11 test cases the skill fixed. Same model, same prompt, with and without the skill.
1 of 11
Prompt
We are attempting to record a stage checkpoint write using `run_checkpoint.py` with `--write` flag but without supplying `--ts`. Will the command successfully update the state?
What was checked, without and with the skill
Checked
Without skill
With skill
Rejects write executions that omit an explicit ISO-8601 timestamp parameter
Passed
Passed
Requires both timestamp and findings parameters for valid checkpoint recording
Missed
Passed
case-18 · gemini-3.6-flash · 8/20/2026 · answers are capped and redacted
What's inside
The instructions your model reads when the skill loads.
SKILL.md349 lines15 filesincludes scripts
Light orchestrator
Coordinate, route and recover the research lifecycle. Do not impersonate the
stage skills and do not turn a deterministic check into a research judgment.
Read
references/orchestrator-resource-map.md
before a real lifecycle run. It defines intake, state authority, migration,
evidence states, access tiers, resident budget and handoff. Read
references/integration-contract.json
when changing any role, gate or route. The detailed rationale is
../../docs/design/orchestrator-spec.md.
Non-negotiable boundaries
Never choose the research direction, final idea, plan, venue, back-edge,
revision-budget exception, known-limitation conversion or final delivery
for the user. Present a recommendation, evidence, alternatives and
consequences, then stop.
reroute.py is advisory. Only
passport.py add-back-edge --authorization-id <user-record> may write a
real back-edge, and only after the user authorizes that exact route.
A back-edge must go to an earlier stage (to < from). The 2⊣3 data
feasibility result is an admission_hold, not a back-edge.
Never call a gate passed from prose. Use a producer's
light.findings.v1, run_checkpoint.py, its exit code, a fresh timestamp
and a content hash.
Never collapse evidence states. Use only VERIFIED, PLANNED, UNKNOWN,
UNAVAILABLE or FAILED.
Never overwrite dirty/untracked user work, silently migrate a passport,
silently rerun a stale downstream chain, or silently mark a limitation.
Never put an overlay or engineering skill in the scientific DAG.
system-design, frontend-design, patent-disclosure and
software-copyright have no stage, findings, STAGE_GATES, ROUTES or
scientific back-edge.
Never claim 23-skill delivery because files exist. Verify the live
inventory, hashes, checkpoints, limitations, handoff and user delivery
decision.
Never silently install or reconfigure local runtimes. If a stage emits an
environment advisory such as r_advisory.requires_user_choice=true, present
Audit, plan, scaffold, and safely migrate research project structures across greenfield, existing Git/non-Git repositories, and monorepo subroots. Use for project folders, repository cleanup, source inventory, move maps, naming and storage policy, Python/R/mixed/LaTeX profiles, template provenance, conflict review, applied-move evidence, or rollback. Existing projects are read-only until the user authorizes exact action IDs bound to a plan digest. Preserve uncommitted and untracked work, symlink