How do I install the Ots Tail skill?

Run npx skillmds@latest add spillwavesolutions/ots-tail 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.

What does the Ots Tail skill do?

Copy a host JSONL transcript into an immutable sessions/ .source.jsonl snapshot. No LLM. It is listed under AI & ML on SkillMD.

Is Ots Tail 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 Ots Tail?

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 Ots Tail free to use?

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

Who published Ots Tail?

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

Ots Tail by spillwavesolutions — Agent Skill

Name: Ots Tail
Author: spillwavesolutions

File contents

python3 "${CLAUDE_PLUGIN_ROOT}/scripts/ots_tail_jsonl.py" once \
  --jsonl /path/to/host-session.jsonl \
  --host claude-code \
  --role software_engineer --agent atlas --n 1 \
  --author "${SECOND_BRAIN_IDENTITY:-local/tailer}" \
  --bundle "$SECOND_BRAIN_ROOT"

Commands: once · follow · start · stop · status · check · setup · opt-in · opt-out · smoke

Install is not capture. Create a project marker or opt in a transcript before anything is written:

touch .okf-history
# or one-off:
python3 "${CLAUDE_PLUGIN_ROOT}/scripts/ots" opt-in --jsonl /path/to/host-session.jsonl --bundle "$SECOND_BRAIN_ROOT"

No marker and no session opt-in → skip entirely (no .source.jsonl, hub, or cursor). Do not infer opt-in from an existing OKF bundle.

--follow / follow is long-running. once copies if the host grew, then exits.
Idle flush default is 300 seconds (dogfood may use --idle 60 if follow stalls; do not change the default unless asked). Cursor (path, pos or size/mtime, session_id, updated_at) makes restart idempotent.
check exits 1 on missing source, unset identity, a stale cursor, or not_opted_in. status and check print the absolute .okf-history candidates walked plus jsonl / session id when skipped.
setup writes okf/temporal/tailer.json in the bundle. --edition a verifies the host CLI + pinned cheapest model (claude-haiku-4-5 / gpt-5.6-luna / grok-4-fast); --edition b verifies the API key env. Sonnet / Sol / Terra / any non-pin fails closed. Never hard-code a private remote. Optional overlay: ~/.okf/ots-tail.json.
Session hub via write-session --ensure-spine. Same slug across hours; new segment on hour rollover.
ots smoke (or ots-tail smoke): fixtures + --stub. No API key.

Pipeline: tail → tick-hour → summarize-hour → rollup → overnight pointers (separate).

Do not run Haiku or pointer batch from the tailer. Do not store a vendor-neutral emit JSONL. Snapshot rule: docs/PRD-TELEMETRY-PHASE1.md. Read-time filter: docs/TELEMETRY_EMIT.md.

---name: ots-taildescription: Copy a host JSONL transcript into an immutable sessions/<slug>.source.jsonl snapshot. No LLM.---```bashpython3 "${CLAUDE_PLUGIN_ROOT}/scripts/ots_tail_jsonl.py" once \ --jsonl /path/to/host-session.jsonl \ --host claude-code \ --role software_engineer --agent atlas --n 1 \ --author "${SECOND_BRAIN_IDENTITY:-local/tailer}" \ --bundle "$SECOND_BRAIN_ROOT"```Commands: `once` · `follow` · `start` · `stop` · `status` · `check` · `setup` · `opt-in` · `opt-out` · `smoke`Install is not capture. Create a project marker or opt in a transcript **before** anything is written:```bashtouch .okf-history# or one-off:python3 "${CLAUDE_PLUGIN_ROOT}/scripts/ots" opt-in --jsonl /path/to/host-session.jsonl --bundle "$SECOND_BRAIN_ROOT"```No marker and no session opt-in → skip entirely (no `.source.jsonl`, hub, or cursor). Do not infer opt-in from an existing OKF bundle.- `--follow` / `follow` is long-running. `once` copies if the host grew, then exits.- Idle flush default is 300 seconds (dogfood may use `--idle 60` if follow stalls; do not change the default unless asked). Cursor (`path`, `pos` or `size`/`mtime`, `session_id`, `updated_at`) makes restart idempotent.- `check` exits 1 on missing source, unset identity, a stale cursor, or `not_opted_in`. `status` and `check` print the absolute `.okf-history` candidates walked plus jsonl / session id when skipped.- `setup` writes `okf/temporal/tailer.json` in the bundle. `--edition a` verifies the host CLI + pinned cheapest model (`claude-haiku-4-5` / `gpt-5.6-luna` / `grok-4-fast`); `--edition b` verifies the API key env. Sonnet / Sol / Terra / any non-pin fails closed. Never hard-code a private remote. Optional overlay: `~/.okf/ots-tail.json`.- Session hub via `write-session --ensure-spine`. Same slug across hours; new segment on hour rollover.- `ots smoke` (or `ots-tail smoke`): fixtures + `--stub`. No API key.Pipeline: tail → `tick-hour` → `summarize-hour` → `rollup` → overnight pointers (separate).Do not run Haiku or pointer batch from the tailer. Do not store a vendor-neutral emit JSONL. Snapshot rule: [docs/PRD-TELEMETRY-PHASE1.md](../../docs/PRD-TELEMETRY-PHASE1.md). Read-time filter: [docs/TELEMETRY_EMIT.md](../../docs/TELEMETRY_EMIT.md).

Frequently asked questions

Ots Tail