obtnet-node

Operate THIS machine as an obtnet fleet node — launching the node daemon correctly, what the controller may do to this machine (jobs, builds into the staging, checkout gitsync/sync), node-side etiquette and troubleshooting. Use when setting up, running, or debugging the node side of the fleet (the controller-side…

Skill for Claude CodeCodex

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/tweakoz/orkid/obtnet-node
Any agent
npx skills add tweakoz/orkid --skill obtnet-node
Clone the repo
git clone --depth 1 https://github.com/tweakoz/orkid

Made for: Claude Code, Codex.

Per session 77 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,634 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00077 $0.01634
Opus 5 $0.00039 $0.00817
Sonnet 5 $0.00015 $0.00327
Haiku 4.5 $0.00008 $0.00163

Measured today against content hash e26508c75dc6, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

obtnet-node scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured today.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

.claude/skills/obtnet-node/SKILL.md · 96 lines

How it starts

The opening of the file, as written. The whole thing — 96 lines — stays where its author put it; the contents beside it link to each section on GitHub.

obtnet-node — this machine as a fleet node

A node is a small daemon (obt.net.node.py) that registers with the controller, heartbeats, and executes relayed work. Its terminal console is a first-class UI: one compact line per event (connect, run→/done rc+duration+bytes, uploads, job state changes) — run it somewhere you can watch.

The launch law (non-negotiable)

Nodes ALWAYS run inside an obt shell. Jobs inherit the node's environment verbatim — the obt shell is what makes bare tools (ork.build.py, obt.dep.*, ork.cpp.db.*) resolve and what points them at THIS machine's staging + project checkout.

# inside an obt shell (obt.env.launch.py --stagedir <stage> [--project <checkout>]):
obt.net.node.py --controller <controller-host>     # port defaults to 7461

Name defaults to the hostname. Never launch a node "naked" (plain ssh session): a partial environment produces confusing distant failures — ModuleNotFoundError: obt, empty $OBT_STAGE — instead of a loud local one. Temp/extra nodes go through obt.env.launch.py --stagedir <stage> --command obt.net.node.py too.

Two kinds of node on this machine (never conflate)

  • WORKER node — everything else in this file: executes jobs in this machine's staging and checkout. Normally HUB-started from FLEET.json during fleet bringup (owner jul30); hand-start only on direct instruction. Agents outside the hub's bringup flow never start one — they print the launch line.
  • MAILBOX nodeobt.net.node.py … --name coord-<seat> --restrict msg,sync: a coordinator seat's mail endpoint. It executes NO work: --restrict msg,sync allows only the message-deposit tool and git (so sync/gitsync still work), and everything else comes back as restricted node <name> refuses …. It belongs to that seat's COORDINATOR, who starts and restarts it unprompted; the launch line lives in that seat's bringup procedure (.claude/skills/hub-coordinator/BRINGUP.md / .claude/skills/sub-coordinator/BRINGUP.md), not here. Placement rule: a HUB's mailbox joins the hub's OWN controller; a SUB's mailbox joins the HUB's controller — that is how hub-to-sub mail arrives.

Read the full file on GitHub · 96 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. today First seen · 96 lines · 77 tokens per session scan A e26508c75dc6

Subscribe to this mod's changes

obtnet-node is a skill published in the GitHub repository tweakoz/orkid (35 stars, last pushed 20d ago), licensed MIT. It adds 77 tokens to every session and 1,634 once invoked, about $0.0004 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-09-01.

Related

Other skills, from other repositories

host-pattern

Use when adding a new domain to Nuclear's plugin system, or implementing a host. Covers the host pattern (how player functionality is exposed to plugins), the host interface and API class structure, how hosts are implemented in the player, error handling conventions, and what files to create and modify. Trigger…

nukeop/nuclear · 86 tokens

creating-components

Use when creating new UI components in packages/ui. Covers component structure, tests, stories, and what to avoid.

nukeop/nuclear · 26 tokens

writing-docs

Use when writing or editing documentation in packages/docs. Covers Gitbook markdown syntax, special blocks, page structure, and the SUMMARY.md table of contents. Trigger phrases include "write docs", "add documentation", "docs page", "gitbook", "user manual".

nukeop/nuclear · 57 tokens

writing-plugins

Use when writing, scaffolding, or modifying Nuclear plugins. Covers plugin structure, manifest, entry point, provider types, available APIs, and publishing. Trigger phrases include "create a plugin", "write a plugin", "plugin scaffold", "streaming provider", "metadata provider".

nukeop/nuclear · 60 tokens

nemoclaw-contributor-implement-issue

Implement an accepted NemoClaw GitHub issue in the current checkout. Use when a user asks to pick up an issue for implementation, implement or fix a named issue, or add the issue's tests. Confirm accepted scope, deliver the smallest independently valuable capability slice, and record validation and remaining gates…

NVIDIA/NemoClaw · 134 tokens

amazon-reviews-api-skill

This skill helps users automatically extract Amazon product reviews via the Amazon Reviews API. Agent should proactively apply this skill when users express needs like getting reviews for Amazon product with ASIN B07TS6R1SF, analyzing customer feedback for a specific Amazon item, getting ratings and comments for a…

browser-act/skills · 124 tokens