About

Imported from joelhooks/joelclaw (skills/fleet-ops/SKILL.md). Install upstream with npx skills add joelhooks/joelclaw --skill fleet-ops. Copyright stays with the author.

Fleet Operations

Name: fleet-ops
Author: joelhooks

Use this to inspect the JoelClaw Mac fleet without flattening intentional role differences into fake drift.

Resolve current Central ownership from the private manifest and live evidence. Satellites stay thin. A role difference is policy only when the local private fleet manifest says why.

Current commands: read-only

joelclaw fleet status
joelclaw fleet diff

Both commands read the local private fleet manifest and return JSON envelopes. They do not install packages, copy config, request repair, change services, or rewrite a Machine.

Use --host <alias> to inspect one declared host. Do not pass an undeclared target or publish the private manifest.

status reports observed facts and probe failures. diff classifies declared fields as:

in_sync
expected_difference — an explicit manifest exemption, including its reason
drift — an actionable mismatch
unavailable — a required fact could not be read

A failed or unavailable satellite health probe is actionable. Thin satellite skill policy alone is not.

Operator flow

Probe — run joelclaw fleet status.
Classify — run joelclaw fleet diff; read the exemption reason before calling a difference wrong.
Inspect — verify unexpected drift with the relevant host/runbook. Do not infer host identity from an SSH alias alone.
Plan — write a host-scoped, reviewable change plan. Fleet plan does not exist yet.
Authorize — use authorization already given for the named host change. Ask only for a mutation outside that scope; an audit alone authorizes no repairs.
Apply — use the approved, host-specific mechanism. Fleet apply does not exist yet. Never pretend it does.
Verify — rerun status and diff, then capture a redacted receipt.

If a probe cannot reach a host, record unavailable and keep gathering the other hosts. Do not turn on Remote Login, alter Tailscale, copy credentials, or bootstrap a Machine as a side effect of an audit.

Role boundaries

Central: Use the verified owner in current service placement. Verify Central health through the established system runbooks before changing it.
Satellite: keep the Machine local, small, and recoverable. Load Satellite Rig for setup or repair.
Network and host routing: load the locally installed panda-host, tailnet-topology, and operator-network guidance. Those private/operator resources are not canonical content of this public repo; do not copy them here or expose their topology.

Guardrails

Keep actual host routing, auth, and other fleet details in the local private manifest, never a public repo, issue, or output envelope.
Treat SSH identity mismatch as actionable until independently explained.
Do not auto-converge role policy. A Central and a thin satellite should not have the same service or skill surface by default.
Run satellites first and Central last only after a reviewed mutation plan exists.
Keep fleet audit output redacted before sharing it outside the operator environment.

Use it

Copy one of these into your project. Installing also returns the manifest and these snippets.

yaml

targets:
  - https://api.opensmartroute.ai/api/v1/registry/joelhooks-joelclaw-fleet-ops/manifest   # or paste the manifest below

Manifest

An Open Capability Manifest: the router reads it to know what this does, what it costs and when to pick it.

joelhooks-joelclaw-fleet-ops.ocm.jsonjson

{
  "ocm": "1",
  "id": "joelhooks-joelclaw-fleet-ops",
  "kind": "skill",
  "name": "fleet-ops",
  "description": "Inspect JoelClaw Mac fleet harness drift safely. Use for fleet status/diff, role-aware Pi and skill-policy checks, or planning a reviewed fleet change.",
  "publisher": "joelhooks",
  "version": "1.0.0",
  "capabilities": {
    "domains": [
      "general"
    ],
    "tags": [
      "skill-md",
      "joelclaw",
      "fleet",
      "macos",
      "pi",
      "operations",
      "skills-sh"
    ],
    "languages": [
      "en"
    ]
  },
  "quality_prior": 0.6,
  "examples": [
    "Inspect JoelClaw Mac fleet harness drift safely. Use for fleet status/diff, role-aware Pi and skill-policy checks, or planning a reviewed fleet change."
  ],
  "primary": false,
  "metadata": {
    "source": {
      "provider": "skills.sh",
      "repository": "https://github.com/joelhooks/joelclaw",
      "path": "skills/fleet-ops/SKILL.md",
      "ref": "HEAD",
      "url": "https://github.com/joelhooks/joelclaw/blob/HEAD/skills/fleet-ops/SKILL.md",
      "key": "joelhooks/joelclaw/skills/fleet-ops/SKILL.md"
    }
  },
  "instructions": "# Fleet Operations\n\nUse this to inspect the JoelClaw Mac fleet without flattening intentional role differences into fake drift.\n\nResolve current Central ownership from the private manifest and live evidence. Satellites stay thin. A role difference is policy only when the local private fleet manifest says why.\n\n## Current commands: read-only\n\n```bash\njoelclaw fleet status\njoelclaw fleet diff\n```\n\nBoth commands read the local private fleet manifest and return JSON envelopes. They do not install packages, copy config, request repair, change services, or rewrite a Machine.\n\nUse `--host <alias>` to",
  "cost": {
    "context_tokens": 776
  }
}

Fetch it by URL: GET /api/v1/registry/joelhooks-joelclaw-fleet-ops/manifest?version=1.0.0

Reviews

Star ratings from people who tried it. One review per account; edit yours any time.

No reviews yet. Install it, try it, and be the first to rate it.