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
Most recently taken up by
- shanselman/openclaw-windows-hubword for word, first seen Nov 16, 2026
Who's talking about openclaw/openclaw-windows-node
- microsoft/microsoft-ui-xaml“Code generator generates warnings on obsolete class with CreateFromString attributes”GitHub · Oct 24, 2025 · 7 reactions
- openclaw/openclaw“feat: expose session classification facts”GitHub · Jul 13, 2026 · 2 reactions
- @ragnarheil.de“#MSBUILD Highlight: A Windows companion suite for #OpenClaw - the AI-powered personal assistant. Made with …”Bluesky · Jun 2, 2026 · 2 likes
- A Hacker News story“OpenClaw Windows Hub”Hacker News · Jun 2, 2026 · 2 points
- openclaw/openclaw“fix(node): warn when MSIX computer control targets an isolated desktop”GitHub · Nov 13, 2026 · 1 reactions
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
- Oct 24, 2025Code generator generates warnings on obsolete class with CreateFromString attributes — microsoft/microsoft-ui-xaml7 reactions · 1 comment
- Jul 13, 2026feat: expose session classification facts — openclaw/openclaw2 reactions · 8 comments
- Nov 13, 2026fix(node): warn when MSIX computer control targets an isolated desktop — openclaw/openclaw1 reaction · 4 comments
- Nov 13, 2026docs: clarify the MSIX interactive desktop node limitation — openclaw/openclaw-windows-packaging1 reaction · 4 comments
- Oct 27, 2026fix(copilot): discover models with usable saved sign-ins — openclaw/openclaw1 reaction · 2 comments
14 more on GitHub
- Oct 15, 2026feat: notify Windows monitoring after Gateway package publication — openclaw/openclaw1 reaction · 9 comments
- Oct 14, 2026feat(gateway): share localized welcome content with native clients — openclaw/openclaw1 reaction · 9 comments
- Oct 14, 2026fix: acknowledge slow Gateway starts without failing setup — openclaw/openclaw-windows-packaging1 reaction · 2 comments
- Oct 13, 2026fix: keep chat usable after removing an unavailable tool server — openclaw/openclaw1 reaction · 6 comments
- Oct 10, 2026[Feature]: Track official MXC v1 adoption across Core, Windows Node and native Gateway packaging — openclaw/openclaw1 reaction · 1 comment
- Oct 7, 2026fix: preserve isolated capability in clawctl error responses — openclaw/openclaw-windows-packaging1 reaction · 4 comments
- Sep 8, 2026Windows node approval replay rejects with possible prepared-plan sessionKey inconsistency — openclaw/openclaw1 reaction · 5 comments
- Aug 28, 2026Define the Companion and Gateway lifecycle contract — openclaw/openclaw-windows-packaging1 reaction · 3 comments
- Aug 5, 2026feat(release): validate Windows-node releases and main — openclaw/openclaw1 reaction · 35 comments
- Jul 31, 2026fix(protocol): preserve gateway session attribution across node runs — openclaw/openclaw1 reaction · 67 comments
- Jul 18, 2026[Bug]: Gateway RPC wizard inherits CLI process and service lifecycle — openclaw/openclaw1 reaction · 2 comments
- Jul 13, 2026Maintainer application: requesting contribution triage/maintenance path — openclaw/openclaw1 reaction · 1 comment
- Jun 4, 2026Add screen_snapshot action (parity with screen_record) to avoid base64 context bloat — openclaw/openclaw1 reaction · 1 comment
- Jun 3, 2026clawsweeper re-review fails for repos with default branch of 'master' instead of 'main' — openclaw/clawsweeper1 reaction · 2 comments
On Bluesky · 3
- Jun 2, 2026#MSBUILD Highlight: A Windows companion suite for #OpenClaw - the AI-powered personal assistant. Made with 🦞 love by Scott Hanselman and… — @ragnarheil.de2 likes and reposts
- Jun 3, 2026Microsoft anuncia la app oficial de OpenClaw. Permite al agente controlar tu Windows: ✓ Permisos integrados ✓ Control total desde la… — @midu.dev1 likes and repost · 1 reply
- Jun 4, 2026🚀 Skyrocketing! 🚀 (200+ new stars) 📦 openclaw / openclaw-windows-node ⭐ 1,161 (+331) 🗒 C# Windows companion suite for OpenClaw - System… — @github-trending.bsky.social0 likes and reposts · 1 reply
On Hacker News · 1
- Jun 2, 2026OpenClaw Windows Hub2 points
Other versions1 project uses a version of this.
Word for word · 1
- shanselman/openclaw-windows-hub★ 2.2k100% same
Edited · 0
None found.
Wrote their own version · 0
None found.
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository18 other files it gives its agents.
- AGENTS.mdAGENTS.md
- docs/AGENTS.mdAGENTS.md
- autoreviewSkill
- crabboxSkill
- global-repo-triageSkill
- hanselman-code-reviewSkill
- native-gateway-from-sourceSkill
- openclaw-debuggingSkill
- openclaw-proof-validationSkill
- openclaw-testingSkill
- pr-simplifySkill
- retrigger-flaky-ciSkill
- technical-documentationSkill
- test-auditSkill
- uninstallSkill
- windows-app-mcpSkill
- windows-pr-prepareSkill
- winnodeSkill
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
- Distinctive: line 17
Read the affected rows in the ownership ledger and the owning guide linked from AGENTS.md.
- Distinctive: line 19
Do not create another ownership ledger or a parallel client/state store.
- Distinctive: line 26
Read implementations and tests, not only method names or an exit code.
- Distinctive: line 27
Write the boundary invariants below in the task's plan or private evidence.
- Distinctive: line 47
Do not add streaming, a broker, a database or a general operation framework unless the boundary's requirements actually need it.
- Distinctive: line 70
Timeout is an observation result: Before dispatch, expiry may prevent work.
- Distinctive: line 88
If external effects cannot commit atomically with the record, require recoverable intent/reconciliation and name residual ambiguity.
- Distinctive: line 110
Use the existing supported contract, including capability/version negotiation, before declaring a feature missing.
- Distinctive: line 129
Do not guess a minimum released version from a source commit.
- Distinctive: line 139
No sleeps, longer timeouts, log parsing, unconditional cleanup or speculative fallback may substitute for required producer guarantees.
- Distinctive: line 146
Use the existing test harness and the test authoring, test selection and proof routes.
≈ “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.
Files
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
- 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.
- 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.
- 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.
- 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.
| Question | Required 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:
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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 injection | Observable assertion |
| Drop acknowledgment after acceptance/commit | Reconcile same identity; no blind mutation replay or false terminal failure |
| Duplicate/reorder events; disconnect at snapshot/subscribe | No missed required transition or stale state regression; recover from reconnect/history expiry |
| Crash between effect and receipt; concurrent same key | Recover intent/outcome without duplicate effect; reject changed parameters; expose expiry ambiguity |
| Stale cleanup or delayed write after a new owner | Receiver rejects obsolete authority at the side-effect boundary; newer state survives |
| Cancel as completion commits; child still running | Terminal winner preserved; requested/stopped/drained/compensated remain distinct |
| New boot reuses PID/port; stale config/health reply | Reject stale generation/revision; verify fresh own-identity admission as required |
| Exact timeout/no-progress boundaries with virtual clocks | Finite calls and outer ceiling; wall-clock jumps/heartbeats do not extend budget; pre/post-dispatch outcomes differ |
| Retry storm, unsupported producer, authorization failure | One 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.
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
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.

