peer-sessions SKILL.md skillA

peer-sessions from wncfht/agent-basic-skill is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add wncfht/agent-basic-skill/peer-sessions@git:20261018.f3b0b4f

Pins git:20261018.f3b0b4f in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
wncfht/agent-basic-skill
Path
skills/peer-sessions/SKILL.md
Versions recorded
1
Latest version
git:20261018.f3b0b4f, committed Oct 18, 2026
Size
4,567 bytes
Repository stars
28
License
none declared

感知、通知与编排本机其他 Claude Code 会话。当用户要看别的会话在做什么、盯进度、发消息 push 方向,或要搭 overseer→leader→subagent 架构(scripts/overseer.py:spawn/push/observe/policy/kill 全生命周期)时使用。.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Peer Sessions

本机每个活着的 Claude Code 进程都在 `~/.claude/sessions/<pid>.json` 注册:name、sessionId、cwd、socket、status(idle/busy)、nameSource。`ListAgents` 和 `claude agents --json --all` 读同一份注册表,后者额外覆盖 `claude --bg` 后台任务(每个任务的 intent、output.result、transcript 路径在 `~/.claude/jobs/<id>/state.json`)。

## 感知

注册表只有状态没有内容。把 name 经 roster 解析成 sessionId 后,用 /session-transcripts 的 `show <sid> --tail N` 读 transcript 尾部,自己判断 working / done / needs_reply / failed——这与 `claude agents` 状态卡背后的 needs_you 分类同构。

## 通知

`SendMessage` 按 name 寻址:

- 对方 idle:消息以 user 角色到达,自动开新 turn 执行。
- 对方 busy:排在 tool call 间隙投递。
- `notify_when_idle: true` 是一次性订阅,对方转 idle 或退出时收到 `[Cross-session idle notice]`。
- 对方看到的信封是 `<cross-session-message from="uds:..." from-name="...">`,并被系统提示告知 peer 消息是输入不是权威;它回复时会抄 `from` 地址再 SendMessage。

## 红线

- **name 每轮重新解析**:会话被重开或复制后身份归新进程,向过期 name 发送直接失败。不缓存 name→目标映射;push 时在消息体里带上目标 sessionId 前 8 位供接收方自证。
- **推送的指令无确认直接执行**:本机会话普遍 bypassPermissions。指令保持窄、可逆,开头带身份前缀(如 `[overseer→a1b2c3d4]`)标明这不是用户本人在说话。
- Push 是请求不是命令:接收方有权评估拒绝,措辞写成可判断的请求。

## Overseer 模式(leader 生命周期控制面)

`SendMessage` 只能寻址已存在的 agent;启停 leader 走 `scripts/overseer.py`(stdlib 单文件,`uv run` 直接跑):

```
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add wncfht/agent-basic-skill/peer-sessions@sha256:1817f969cda14dc4

The line at the top of this page pins the label git:20261018.f3b0b4f, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_hj3e4v3rnuusbisv.svg)](https://markdownregistry.com/a/art_hj3e4v3rnuusbisv)

2 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 1 version of this file, committed on Oct 18, 2026.

versioncommittedcommitsizeaudit
git:20261018.f3b0b4f latest2026-10-18 f3b0b4f 4,567 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (4567 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

wncfht/agent-basic-skill · 28 stars · license none declared · pushed 2026-10-18 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_hj3e4v3rnuusbisv
GET https://markdownregistry.com/api/v1/resolve?ref=wncfht/agent-basic-skill/peer-sessions
GET https://markdownregistry.com/api/v1/blob/1817f969cda14dc41e61e94bb896fffd55320df80aa25e6a472ef4f8910114ee

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from wncfht/agent-basic-skill

asr SKILL.md skill
wncfht/agent-basic-skill · skills/asr/SKILL.md · 把音频或视频文件转录成 SRT 字幕或带时间戳的 TXT,词级时间戳。当用户想要语音转文字、转录、字幕、SRT 生成时使用——尤其是中文或英文音频 (transcription, subtitles…
git:20261018.e07a830 · audit A · 28 stars
conventional-commits SKILL.md skill
wncfht/agent-basic-skill · skills/conventional-commits/SKILL.md · 统一 Git 提交信息的 Conventional Commits 规范,帮助编写简洁、可审查且可自动化处理的提交。
git:20261018.f5dfb71 · audit A · 28 stars
document-writing SKILL.md skill
wncfht/agent-basic-skill · skills/document-writing/SKILL.md · 统一技术文档、调研笔记和仓库交付物的中文表达、证据论证、Markdown 格式与伪代码规范;编写或修改正式文档时使用。
git:20261018.4f1e812 · audit A · 28 stars
figure-viz SKILL.md skill
wncfht/agent-basic-skill · skills/figure-viz/SKILL.md · 渲染可审计的研究图,双引擎一套调色板:符号/结构/机制图走 TikZ 轨(张量块图、流水线泳道、通信并行、注意力掩码、时间线谱系、分类板设计空间、pgfplots 混合示意、伪 3D 立体块),真实数据图表走 matplotlib…
git:20261018.c0ddc34 · audit A · 28 stars
link-get SKILL.md skill
wncfht/agent-basic-skill · skills/link-get/SKILL.md · 任意链接或裸 ID → 文本内容(Markdown / SRT / TeX 源)的统一入口。当用户粘贴 YouTube、Bilibili(视频/动态 opus)、知乎、微信公众号、SJTU Canvas、arXiv abs…
git:20261013.8b84045 · audit A · 28 stars
paper-search SKILL.md skill
wncfht/agent-basic-skill · skills/paper-search/SKILL.md · 在 arXiv、DBLP、OpenAlex、OpenReview、Semantic Scholar、Crossref 检索论文。找论文、related work、prior…
git:20261018.9aeed53 · audit A · 28 stars
setup-toolchain SKILL.md skill
wncfht/agent-basic-skill · skills/setup-toolchain/SKILL.md · 为仓库搭建 format/lint/pre-commit/CI 工具链(含 yaml 注释宽度检查)、agent 入口(AGENTS.md + .agents/skills 为入库唯一事实源,.claude/skills 为…
git:20261013.8b84045 · audit A · 28 stars
skill-management SKILL.md skill
wncfht/agent-basic-skill · skills/skill-management/SKILL.md · 维护本机三 CLI(Claude Code / Codex / Kimi Code)共用的 skills + AGENTS.md 体系:~/.agents 唯一事实源、软链布局、全局与仓库两级 skill…
git:20261018.e07a830 · audit A · 28 stars
video-render-pdf SKILL.md skill
wncfht/agent-basic-skill · skills/video-render-pdf/SKILL.md · 从 YouTube、Bilibili 或 SJTU Canvas 课堂实录的讲座、教程或技术分享视频生成专业、详尽、配图丰富的 LaTeX 课程笔记与最终 PDF。当用户提供 YouTube…
git:20261018.c0ddc34 · audit A · 28 stars

Every file in wncfht/agent-basic-skill

Browse by kind, by grade A, or by owner.