Agent skill

Nucleus Session Binding Report

by protect-my-hair in protect-my-hair/nucleus-marketplace

Collects, freezes and validates a Nucleus V2 session binding report that records the native Claude Code or Codex session ID, transcript path and hash.

MITAuto-check passedAgent Workflows

SKILL.md written in Chinese; this summary is our English description.

Install Nucleus Session Binding Report

skills CLI
$ npx skills add protect-my-hair/nucleus-marketplace --skill session-binding -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install protect-my-hair/nucleus-marketplace session-binding --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/protect-my-hair/nucleus-marketplace.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/nucleus/skills/session-binding .claude/skills/session-binding && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
session-binding
GitHub stars
164
Token cost
~477 tokens
SKILL.md length
92 words
Files
5 (incl. scripts, references, assets)
Skills in repo
18
Repo updated
First seen
Licence
MIT

At a glance

Collects, freezes and validates a Nucleus V2 session binding report that records the native Claude Code or Codex session ID, transcript path and hash.

  • Binding the current Claude Code or Codex session before building a result package
  • SKILL.md covers 子命令, 证据规则 and 边界
  • Runs Python scripts from its folder; calls python3
  • Recording a session ID and transcript hash without copying the transcript

What it does

A fixed-path report named session-binding-report.json is generated for Nucleus V2 workflows, inside the run's session-binding folder. It records only the native session ID, an explicit transcript path and a hash, and never copies transcript or JSONL contents. The SKILL.md is written in Chinese.

A Python script offers three subcommands: collect, freeze and validate-report. Evidence rules put explicit context or CLI metadata first, treat Codex JSON events and Claude hook JSON as reliable, accept the CODEX_THREAD_ID variable only as a candidate that strict modes reject on its own, and forbid guessing a transcript by latest file, modification time or only file. Strict modes, or a constraint requiring binding, produce a blocker when no reliable binding exists, and the hash is computed only for completed, cancelled or freeze-requested runs.

When your agent uses it

  • Binding the current Claude Code or Codex session before building a result package
  • Recording a session ID and transcript hash without copying the transcript
  • Validating an existing session binding report
  • Freezing the binding when a run completes or is cancelled

Example prompts

  • “Collect the session binding for this Nucleus workflow run before we build the result package.”
  • “Validate the session-binding-report.json from the last run.”
  • “Freeze the session binding now that the run is complete.”

Requirements

  • Python 3 to run scripts/session_binding.py
  • A Nucleus V2 workflow with its context file

What it can do on your machine

Read from SKILL.md and the folder at commit 3c82085. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 1 file in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python3

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Nucleus Session Binding Report loads about 477 tokens when it runs, and up to ~813 if it reads all its reference files. Until then it costs about 45 tokens; SKILL.md has 92 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~45
When it runs · the whole SKILL.md, loaded when a task matches
~477
With references · SKILL.md plus every file in references/, read only if the agent opens them
~813

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from protect-my-hair/nucleus-marketplace at commit 3c82085, republished under its MIT licence (© protect-my-hair). 92 words, ~477 tokens.

Download SKILL.mdSave it as .claude/skills/session-binding/SKILL.md (or your agent's skills folder). This skill also uses 4 other files; get the full folder from GitHub.
name
session-binding
description
Nucleus V2 approved-write session binding collector. Use when a workflow must bind the current Claude Code or Codex native session before building a result package.

Session Binding

本 Skill 为 Nucleus V2 workflow 生成固定路径的 session binding report:

.nucleus/runs/<workflowRunId>/session-binding/session-binding-report.json

它只记录原生会话 ID、显式 transcript 路径和 hash,不复制 Claude/Codex transcript 或 JSONL 正文。

子命令

bash
python3 skills/session-binding/scripts/session_binding.py collect \
  --repo-root <target-repo> \
  --context <target-repo>/.nucleus/context/<workflowRunId>.json \
  --provider-policy auto \
  --codex-json-event <event.json>
bash
python3 skills/session-binding/scripts/session_binding.py freeze \
  --repo-root <target-repo> \
  --context <target-repo>/.nucleus/context/<workflowRunId>.json \
  --session-binding-report <target-repo>/.nucleus/runs/<workflowRunId>/session-binding/session-binding-report.json \
  --reason completed
bash
python3 skills/session-binding/scripts/session_binding.py validate-report \
  --report <target-repo>/.nucleus/runs/<workflowRunId>/session-binding/session-binding-report.json

证据规则

  • explicit context / CLI metadata 优先。
  • Codex JSON event 和 Claude hook JSON 是可靠 event evidence。
  • CODEX_THREAD_ID 只能作为 local-verified-env-candidate;strict/PMS 模式不接受单独 env candidate。
  • Claude transcriptPath 只接受 hook JSON、explicit metadata、CLI 参数或 PMS connector 明确输出。
  • 禁止 discoveryMethod=latest|mtime|only-file。
  • 禁止 transcript 正文、message array、JSONL event array 进入 report。
  • strict/PMS 或 constraints.sessionBindingRequired=true 缺可靠绑定时必须输出 blocker。

边界

  • 不 import 根 harness/。
  • 不写 docs/requirement/**。
  • .nucleus/runs/<workflowRunId>/session-binding 若是 symlink,runtime 输出 stdout blocked payload,不写仓库文件。
  • transcript hash 只在 completed、cancelled、pms-freeze-requested freeze reason 下计算。

© protect-my-hair, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 4 other files (scripts, references, assets) in plugins/nucleus/skills/session-binding of protect-my-hair/nucleus-marketplace.

  • SKILL.md
  • agents/openai.yaml
  • assets/nucleus-session-binding-report.schema.json
  • references/session-binding-policy.md
  • scripts/session_binding.py

Open the folder on GitHubat commit 3c82085

Compare with similar skills

Nucleus Session Binding Report next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Nucleus Session Binding Report compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Nucleus Session Binding Report this skillprotect-my-hair/nucleus-marketplace164—~477Automated safety check: PassMIT
Orca CLIstablyai/orca89k2 repos~593Automated safety check: PassMIT
Beads Task Memorygastownhall/beads28k—~1.2kAutomated safety check: PassMIT
Session History Searchslopus/happy24k—~3.1kAutomated safety check: PassMIT
Paseo Agent Handoffgetpaseo/paseo20k1 repos~606Automated safety check: PassCustom licence
Memori Long-Term MemoryMemoriLabs/Memori17k—~2kAutomated safety check: NotesCustom licence

Similar skills

  • Orca CLI

    stablyai/orca

    Operate Orca-managed worktrees, folder contexts, terminals, repos, automations, artifacts, skill sharing, worktree comments, and Orca's embedded browser…

    89k GitHub starsUsed in 2 repos~593 tokens
    Agent WorkflowsAuto-check passed
  • Beads Task Memory

    gastownhall/beads

    Tracks multi-session work with dependencies in the bd issue tracker so the agent can find ready tasks and recover its context after conversation compaction.

    28k GitHub stars~1.2k tokensUpdated today
    Agent WorkflowsAuto-check passed
  • Searches past Claude Code, Codex and Cursor sessions and summarizes what was worked on, tried or decided, using extraction scripts instead of reading raw logs.

    24k GitHub stars~3.1k tokensUpdated today
    Agent WorkflowsAuto-check passed
  • Paseo Agent Handoff

    getpaseo/paseo

    Hands off the current task, including context, decisions and failed attempts, to a fresh agent through Paseo by writing a self-contained briefing prompt and launching that agent.

    20k GitHub starsUsed in 1 repo~606 tokens
    Agent WorkflowsAuto-check passed
  • Memori Long-Term Memory

    MemoriLabs/Memori

    Connects Claude Code to Memori Cloud for long-term memory, recalling stored context before substantive replies and saving new context afterward.

    17k GitHub stars~2k tokensUpdated 8 days ago
    Agent WorkflowsAuto-check: notes
  • Beads

    liwp/again

    A skill your agent uses when working in a repository that uses bd or Beads for durable project task tracking, issue dependencies, blocker management, multi-session handoff, or shared work memory.

    118 GitHub starsUsed in 6 repos~537 tokens
    Agent WorkflowsAuto-check passed

More from protect-my-hair/nucleus-marketplace

All 18 skills in this repo
  • Nucleus Delivery Evidence Closure

    protect-my-hair/nucleus-marketplace

    Collects prior Nucleus task evidence into a candidate-only delivery closure package and PR/MR draft text, blocking if any feature's design, review or verification evidence is missing.

    164 GitHub stars~1k tokensUpdated 2 mo ago
    Auto-check passed
  • Nucleus Context Validator

    protect-my-hair/nucleus-marketplace

    Validates the context file for a Nucleus V2 workflow run, discovers standalone context from explicit input, and writes a blocked result when required context is missing.

    164 GitHub stars~576 tokensUpdated 2 mo ago
    Auto-check passed
  • Nucleus Result Package Builder

    protect-my-hair/nucleus-marketplace

    Builds the result.json file for a Nucleus V2 workflow run from its context, gates, blockers and step status, and exits non-zero when the run is blocked.

    164 GitHub stars~414 tokensUpdated 2 mo ago
    Auto-check passed
  • Defect Intake and RCA Candidates

    protect-my-hair/nucleus-marketplace

    Checks whether a defect report has enough context to be accepted, then drafts candidate-only root-cause evidence for human review without confirming causes or changing code.

    164 GitHub stars~745 tokensUpdated 2 mo ago
    Auto-check passed
  • Nucleus Delivery Evidence Finalizer

    protect-my-hair/nucleus-marketplace

    Combines the evidence from completed Nucleus workflow steps into a final evidence report and result package, without scheduling steps, updating trackers or opening pull requests.

    164 GitHub stars~454 tokensUpdated 2 mo ago
    Auto-check passed
  • Feature Doc Design

    protect-my-hair/nucleus-marketplace

    A skill your agent uses when 特性开发需要直接在产品仓库 docs/features 下写可评审的特性文档和邻近设计文档。

    164 GitHub stars~895 tokensUpdated 2 mo ago
    Auto-check passed

Categories

Questions about Nucleus Session Binding Report

What does Nucleus Session Binding Report do?

Collects, freezes and validates a Nucleus V2 session binding report that records the native Claude Code or Codex session ID, transcript path and hash. json is generated for Nucleus V2 workflows, inside the run's session-binding folder. It records only the native session ID, an explicit transcript path and a hash, and never copies transcript or JSONL contents.

When should I use Nucleus Session Binding Report?

Nucleus Session Binding Report fits situations like: binding the current Claude Code or Codex session before building a result package; recording a session ID and transcript hash without copying the transcript; validating an existing session binding report; freezing the binding when a run completes or is cancelled.

How do I install Nucleus Session Binding Report in Claude Code?

Run `npx skills add protect-my-hair/nucleus-marketplace --skill session-binding -a claude-code`. Or copy the skill folder (plugins/nucleus/skills/session-binding in protect-my-hair/nucleus-marketplace) into .claude/skills/session-binding in your project. Claude Code loads it when a task matches its description.

How do I install Nucleus Session Binding Report in Codex?

Run `npx skills add protect-my-hair/nucleus-marketplace --skill session-binding -a codex`. Or copy the skill folder (plugins/nucleus/skills/session-binding in protect-my-hair/nucleus-marketplace) into .agents/skills/session-binding in your project. Codex loads it when a task matches its description.

Can I use Nucleus Session Binding Report in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add protect-my-hair/nucleus-marketplace --skill session-binding -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/session-binding, .gemini/skills/session-binding, .github/skills/session-binding and .opencode/skills/session-binding in your project.

What does Nucleus Session Binding Report need to run?

Going by SKILL.md and its folder, Nucleus Session Binding Report needs Python for the scripts in its folder and the command-line tools its instructions call (python3). Our summary lists: Python 3 to run scripts/session_binding.py; A Nucleus V2 workflow with its context file.

Does Nucleus Session Binding Report access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Nucleus Session Binding Report safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Nucleus Session Binding Report use?

Nucleus Session Binding Report is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Nucleus Session Binding Report use?

About 477 tokens (SKILL.md is roughly 1.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 336 tokens, read only when the agent opens those files.

What are the alternatives to Nucleus Session Binding Report?

Skills that share tags, products or a category with Nucleus Session Binding Report: Orca CLI (stablyai/orca, 89k stars), Beads Task Memory (gastownhall/beads, 28k stars), Session History Search (slopus/happy, 24k stars) and Paseo Agent Handoff (getpaseo/paseo, 20k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Nucleus Session Binding Report?

protect-my-hair (a GitHub user) maintains it in protect-my-hair/nucleus-marketplace, which has 164 GitHub stars. The repository holds 18 skills in this directory. The repository was last updated on July 23, 2026.

Source: protect-my-hair/nucleus-marketplace on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.