agent-observe
Read-only observation of an agent's parent, siblings, and direct children. Use to inspect family status and bounded recent-message previews without mutating sessions.
- License 许可
- MIT
- 最近更新
- 2026-08-06
- Stars
- ★ 0
- Forks
- 0
01 前言 Front Matter
- name
- agent-observe
- description
- Read-only observation of an agent's parent, siblings, and direct children. Use to inspect family status and bounded recent-message previews without mutating sessions.
02 资源文件 2
- 其他pyproject.toml335 B
- 脚本src/agent_observe/__init__.py1.7 KB
03 SKILL.md 正文
Agent Observe
Observe the current agent's nuclear family through the local daemon: parent, siblings, direct children, and self. Observation is currently limited to family members in the same worker; root siblings in other workers are not observable yet. This skill is read-only: it can list family sessions, inspect one session, and fetch bounded recent message previews. It cannot prompt, steer, clear, kill, rename, or otherwise mutate another session.
Call directly from the kernel:
children = await rlm.list_subagents()
child = next((item for item in children if item.active_session_id), None)
if child is not None:
worker = await agent_observe.get_agent(child.session_name)
recent = await agent_observe.recent_messages(child.session_name, limit=6)
# Deletion is a parent-owned RLM operation, not an observe mutation:
await rlm.delete_subagent(child)
API
await agent_observe.list_agents()returnscurrentandagents. Each agent includes active session id, session id, optional name, runtime kind, cwd, status, streaming state, message count, pending count, and a latest message preview. The list is restricted to self, parent, siblings, and direct children. For direct children,await rlm.list_subagents()also exposes parent-owned lifecycle handles.await agent_observe.get_agent(target)returnsagent, whereagentcontains one agent summary.targetis resolved like other live-session selectors: active id, session id/name, or unambiguous suffix.await agent_observe.recent_messages(target, limit=8, max_chars=800)returns up tolimitrecent bounded message previews for the target session.limitmust be 1-50, andmax_charsmust be 80-2000.
Safety
- This skill is read-only and exposes no mutation commands.
- Targets outside the nuclear family are rejected; transcript reads follow the same family rule as messaging.
- Message access is bounded by count and per-message character limit.
- Prefer status and recent previews for orchestration. Ask the user before using observed context to steer or message another session.
04 同仓库更多 Skills
valid-skill
A valid skill for testing purposes.
unknown-field
A skill with an unknown frontmatter field.
nested-child
Nested skill should be ignored.
root-skill-preferred
Root skill should win.
python-skill
A Python-backed skill for testing.
python-package-missing
A Python skill missing its import package.