agentleFS
openclawopenclaw/openclaw-windows-node/.agents/skills/network-handoff/SKILL.md

network-handoff

Skill2.2k starsChanged 3 days agoMITView on GitHub

Use before generating, changing, or reviewing networking, IPC, or cross-process handoffs, including requests, retries, deadlines, reconnect, process launch, configuration apply, cancellation, and cleanup. Establish confirmation, identity, authority, reconciliation, and producer compatibility before implementation.

1 other project uses a version of this; 1 new project in the last 4 weeks, against 0 the 4 before.

Adopted by

Surging: 1 new project took it in the last 4 weeks, none the 4 weeks before.thin data

Week of Sep 20: 0 new projectsWeek of Sep 27: 0 new projectsWeek of Oct 4: 0 new projectsWeek of Oct 11: 0 new projectsWeek of Oct 18: 0 new projectsWeek of Oct 25: 0 new projectsWeek of Nov 1: 0 new projectsWeek of Nov 8: 1 new project
Sep 2026Oct 2026Nov 2026
New projects taking a version of this file each week, over the 8 weeks our latest run read: only 1 in all, so this is a hint, not a trend.

Most recently taken up by

Who's talking about openclaw/openclaw-windows-node

The biggest 5 of 23 mentions linking to the repository that our crawl found. Each line is their own headline.

See all 23

Talked about on GitHub, Bluesky and Hacker News (23 times).

On GitHub · 19

14 more on GitHub

On Hacker News · 1

The file

We split this skill into the rules it gives an agent

11 rules. About 0 are common, 11 are distinctive, and 0 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈11

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 0

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Read the affected rows in the ownership ledger and the owning guide linked from AGENTS.md.

    line 17
  2. Distinctive:

    Do not create another ownership ledger or a parallel client/state store.

    line 19
  3. Distinctive:

    Read implementations and tests, not only method names or an exit code.

    line 26
  4. Distinctive:

    Write the boundary invariants below in the task's plan or private evidence.

    line 27
  5. Distinctive:

    Do not add streaming, a broker, a database or a general operation framework unless the boundary's requirements actually need it.

    line 47
  6. Distinctive:

    Timeout is an observation result: Before dispatch, expiry may prevent work.

    line 70
  7. Distinctive:

    If external effects cannot commit atomically with the record, require recoverable intent/reconciliation and name residual ambiguity.

    line 88
  8. Distinctive:

    Use the existing supported contract, including capability/version negotiation, before declaring a feature missing.

    line 110
  9. Distinctive:

    Do not guess a minimum released version from a source commit.

    line 129
  10. Distinctive:

    No sleeps, longer timeouts, log parsing, unconditional cleanup or speculative fallback may substitute for required producer guarantees.

    line 139
  11. Distinctive:

    Use the existing test harness and the test authoring, test selection and proof routes.

    line 146

≈ “Common” is an estimate: at least 1 in 5 of the 372,429 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Network and handoff contracts

For code-generating and reviewing agents, across all networking and IPC, not just onboarding. The outcome is the smallest change whose next-step postcondition is established by the actual producer contract. Read-only work stays read-only; this skill grants no runtime, installation, upstream-write, or publication authority.

Trace before editing

  1. Name the reported behavior and the next step it must safely enable. Follow the real caller, transport, receiver, side effect, state owner, and tests. Read the affected rows in the ownership ledger and the owning guide linked from AGENTS.md. Do not create another ownership ledger or a parallel client/state store.
  2. Record worktree/base/HEAD and producer repository/source revision. Separately establish the installed producer build, negotiated protocol/capabilities and selected resource/profile. Main-branch source is not installed-version proof. Historical documents are hypotheses to recheck, not shipping specifications.
  3. Inventory existing request/result schemas, status queries, event delivery, persistence, authorization, retries, limits, cancellation and cleanup owners. Read implementations and tests, not only method names or an exit code.
  4. Write the boundary invariants below in the task's plan or private evidence. Mark unknown or inapplicable fields explicitly. Do not invent infrastructure for fields the changed contract does not need.
QuestionRequired decision
What does the acknowledgment establish?Received, durably accepted, executing, committed, or ready; define persistence/failure scope
What does the next step require?Exact resource, generation, desired/applied revision, freshness and authorization
What identifies and authorizes work?Separate request/operation ID, resource identity, runtime boot/connection generation, revision, and authority/fencing
Who knows the outcome?Authoritative query and its consistency, retention, unknown/expired/not-found meanings; event recovery if used
Who may retry or clean up?One coordinating retry owner, mutation idempotency contract, receiver-side ownership check, cancellation/compensation owner
What bounds waiting and execution?Per-call limit, remaining end-to-end budget, no-progress definition, backend lifetime and cleanup lifetime

Choose the minimal sufficient protocol

A bounded synchronous call is enough when it returns the required committed result with documented semantics. An existing authoritative read plus bounded polling may be simpler than a watch. Long-running work should acknowledge acceptance with a queryable operation handle rather than hold the initial RPC until readiness. Distinguish volatile receipt from durable acceptance explicitly. Do not add streaming, a broker, a database or a general operation framework unless the boundary's requirements actually need it.

Apply the following invariants to the affected path:

  1. Identity is not authority. Correlate replies to their request, resource, boot/connection generation and revision as applicable. A UUID, PID, open port or matching config is not permission. Preserve credential and provenance checks. The receiver must atomically validate current ownership/fencing with its side effect, through its existing serialization/conditional-write seam. A client precheck alone leaves a race.
  2. State establishes correctness; events accelerate observation. Use an authoritative query with adequate freshness/consistency. Snapshot+watch needs a producer-supported revision/cursor bridge, or subscribe/buffer plus a documented snapshot barrier. Recover by resnapshot on reconnect or expired history; reject duplicate, reordered and stale-generation events. Never assume arbitrary events have etcd's delivery guarantees. Without a safe bridge use bounded polling if the query suffices.
  3. Operation outcome and runtime health differ. Terminal operation outcomes are immutable for their documented retention lifetime. Observation sequence increases within its declared scope, but health/readiness may regress. A new boot is a new generation, even on the same endpoint. An old successful launch does not prove that the current runtime is ready.
  4. Timeout is an observation result. Before dispatch, expiry may prevent work. After dispatch, timeout/disconnect may leave the outcome unknown, including effects already committed. Keep that uncertainty separate from authoritative terminal failure. Query by identity; distinguish history expiry from proof of absence. Replay only under an applicable idempotency contract. Never roll back merely because an acknowledgment was lost.
  5. Bound every call and the whole wait. Propagate the remaining end-to-end duration, accounting for queueing, connection/authentication, reads, polling and backoff. Measure local elapsed time monotonically; do not compare unsynchronized process clocks as a deadline protocol. Use existing named, configurable repository limit patterns with measured/justified values. Responsiveness heartbeat is not useful progress. Only documented forward progress renews a no-progress allowance; nothing renews the outer ceiling. Client wait expiry does not implicitly terminate accepted backend work. Specify backend execution, result retention and cleanup ownership separately.
  6. Idempotency must be implemented, not inferred. Establish caller/resource scope, same-key/different-parameters conflict, concurrent deduplication, retention/expiry and the crash-safe relationship of effect and result record. If external effects cannot commit atomically with the record, require recoverable intent/reconciliation and name residual ambiguity. UUIDs and in-memory caches do not establish durable exactly-once execution.
  7. Retry at one coordinating layer. Inventory SDK, transport and workflow retries to avoid multiplication. Define bounded attempts/rate, transient classification, capped backoff with jitter and supported retry hints within the remaining budget. Query retries and mutation retries are different; authentication/conflict/provenance failures are not generic transient errors.
  8. Cancellation is not rollback. Distinguish cancellation requested, execution stopped, descendants drained and cleanup/compensation complete. Completion may win the race. Query the actual terminal outcome. Compensation must be explicit, idempotent, resumable and scoped to current authority at the mutation boundary. Never restore an old snapshot over concurrent edits.
  9. Prove the next step, not a proxy. Saved config is not applied config. Alive, listener owned, startup ready, operator admitted and capability approved are different predicates. Bind the required predicate to current generation/revision/freshness and the actual caller's authorization. Current matching state can permit a next step when the contract says so; it does not prove which historical operation caused it.

Inspect producer support and disposition gaps

Use the existing supported contract, including capability/version negotiation, before declaring a feature missing. Implement only consumer behavior justified by the supported producer versions. An honest compatibility path may offer a weaker explicitly named guarantee if the next step accepts it. Otherwise report the precise unavailable confirmation and stop that transition, not the whole unrelated product.

For each genuine producer gap, record:

  • Repository, authoritative producer file/symbol, pinned SHA and source/test links; distinguish implementation, documented guarantee, runtime proof and installed-version unknowns.
  • Required missing contract, existing support checked, and why consumer reads, local IDs or timing cannot establish it. Separate historical attribution from present-state reconciliation.
  • Minimal versioned producer proposal: schema/semantics, authorization/fencing, persistence/retention, query/recovery and errors only as needed for this path.
  • Compatibility and rollout: capability discovery, producer-first deployment, supported older versions, consumer gating and explicit blocked/degraded state. Do not guess a minimum released version from a source commit.
  • Acceptance tests covering the failure window that requires producer support. Suggest the update to its owning repository; do not silently implement a consumer workaround or mutate another repository without authority.

The pinned onboarding case study illustrates this disposition, not a permanent capability catalog. Recheck it for the task's actual producer revision. Research notes explain the source-supported principles without importing vendor-specific requirements.

No sleeps, longer timeouts, log parsing, unconditional cleanup or speculative fallback may substitute for required producer guarantees. Diagnostic logs can explain a failure, not become an undocumented protocol. Preserve necessary timeouts and all credential/provenance checks.

Select failure proof and hand off

Use the existing test harness and the test authoring, test selection and proof routes. Select applicable cases, including receiver-side tests where a consumer mock cannot prove the guarantee:

Failure injectionObservable assertion
Drop acknowledgment after acceptance/commitReconcile same identity; no blind mutation replay or false terminal failure
Duplicate/reorder events; disconnect at snapshot/subscribeNo missed required transition or stale state regression; recover from reconnect/history expiry
Crash between effect and receipt; concurrent same keyRecover intent/outcome without duplicate effect; reject changed parameters; expose expiry ambiguity
Stale cleanup or delayed write after a new ownerReceiver rejects obsolete authority at the side-effect boundary; newer state survives
Cancel as completion commits; child still runningTerminal winner preserved; requested/stopped/drained/compensated remain distinct
New boot reuses PID/port; stale config/health replyReject stale generation/revision; verify fresh own-identity admission as required
Exact timeout/no-progress boundaries with virtual clocksFinite calls and outer ceiling; wall-clock jumps/heartbeats do not extend budget; pre/post-dispatch outcomes differ
Retry storm, unsupported producer, authorization failureOne bounded retry owner; no multiplied retries or invented compatibility success

For a small read-only query change, retain only the relevant invariants/cases and explain exclusions; do not demand a full onboarding E2E suite. For runtime claims, collect current-head evidence at the real changed boundary or name the blocker. A fixture proves only its simulated contract.

Handoff: changed owner and invariant, exact source/build/version evidence, confirmation actually achieved, commands/results, unverified boundaries and upstream dispositions. Do not claim stronger guarantees than the producer.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.