How do I install the Overcast Event Bisect skill?

Run npx skillmds@latest add kdr/overcast-event-bisect in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Overcast Event Bisect safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Overcast Event Bisect?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Overcast Event Bisect free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Overcast Event Bisect?

kdr (@kdr) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Overcast Event Bisect by kdr — Agent Skill

Name: Overcast Event Bisect
Author: kdr

File contents

overcast-event-bisect

Use this skill when a video contains a single MONOTONE transition — a condition that is false before some instant and true after it (or vice versa), and does not flip back. Binary search finds it in about log2(window/precision) vision calls (~12 calls localizes to ~1s inside an hour). Use the broad overcast skill and overcast/reference/verbs.md for exact flags.

Workflow

Local clip + record id (see frame:// needs media on disk):

overcast doctor --json
overcast case init --json
overcast watch ./clip.mp4 --json        # -> record id REC (also gives shot context)

Confirm the transition is bracketed AND monotone — the two endpoints must disagree on the predicate:

overcast see frame://REC@<lo> --prompt "Is <predicate> true? answer only yes or no" --json
overcast see frame://REC@<hi> --prompt "Is <predicate> true? answer only yes or no" --json

If both give the same answer, the flip isn't in [lo,hi]. If the predicate toggles more than once, it isn't monotone — use overcast-pinpoint instead.

Bisect: test the midpoint, keep the half that still straddles the flip, repeat until hi - lo is within your precision:

overcast see frame://REC@<mid> --prompt "Is <predicate> true? answer only yes or no" --json
# keep the straddling half: if mid's answer == lo's answer, set lo=mid; else hi=mid
# (correct whichever way it flips — false->true OR true->false)

Report the transition window and show it:

overcast note "<predicate> flips" --ref REC --at <lo-hi> --confidence high --json
overcast view REC --at <lo-hi> --json
overcast brief --export ./transition.md --json

Output

The converged [lo, hi] bracket — the two adjacent see frames that straddle the flip (their record.ids + media.at) — and the call count. That bracket IS the answer window — don't over-claim a single frame.

Caveats

Bisection is only valid for a one-way change; a light that blinks or a person who comes and goes will mislead it — verify monotonicity at step 2, and fall back to overcast-pinpoint (peak search) or overcast-presence-window for recurring or interval events. Needs the video local.

---name: overcast-event-bisectdescription: Localize the exact instant of a one-way state change (light on, door opens, poster removed) by binary-searching frames — ~log2(N) VLM calls.---# overcast-event-bisectUse this skill when a video contains a single MONOTONE transition — a conditionthat is false before some instant and true after it (or vice versa), and does notflip back. Binary search finds it in about log2(window/precision) vision calls(~12 calls localizes to ~1s inside an hour). Use the broad `overcast` skill and`overcast/reference/verbs.md` for exact flags.## Workflow1. Local clip + record id (`see frame://` needs media on disk):```bashovercast doctor --jsonovercast case init --jsonovercast watch ./clip.mp4 --json # -> record id REC (also gives shot context)```2. Confirm the transition is bracketed AND monotone — the two endpoints must disagree on the predicate:```bashovercast see frame://REC@<lo> --prompt "Is <predicate> true? answer only yes or no" --jsonovercast see frame://REC@<hi> --prompt "Is <predicate> true? answer only yes or no" --json``` If both give the same answer, the flip isn't in `[lo,hi]`. If the predicate toggles more than once, it isn't monotone — use `overcast-pinpoint` instead.3. Bisect: test the midpoint, keep the half that still straddles the flip, repeat until `hi - lo` is within your precision:```bashovercast see frame://REC@<mid> --prompt "Is <predicate> true? answer only yes or no" --json# keep the straddling half: if mid's answer == lo's answer, set lo=mid; else hi=mid# (correct whichever way it flips — false->true OR true->false)```4. Report the transition window and show it:```bashovercast note "<predicate> flips" --ref REC --at <lo-hi> --confidence high --jsonovercast view REC --at <lo-hi> --jsonovercast brief --export ./transition.md --json```## OutputThe converged `[lo, hi]` bracket — the two adjacent `see` frames that straddlethe flip (their `record.id`s + `media.at`) — and the call count. That bracket ISthe answer window — don't over-claim a single frame.## CaveatsBisection is only valid for a one-way change; a light that blinks or a person whocomes and goes will mislead it — verify monotonicity at step 2, and fall back to`overcast-pinpoint` (peak search) or `overcast-presence-window` for recurring orinterval events. Needs the video local.

Frequently asked questions

Overcast Event Bisect