claims

Claims-based authorization for agents and operations. Grant, revoke, and verify permissions for secure multi-agent coordination. Use when: permission management, access control, secure operations, authorization checks. Skip when: open access, no security requirements, single-agent local work.

By ruvnet · 1,121 installs

npx skills add ruvnet/ruflo --skill claims

Source repository · Upstream listing

Claims Authorization Skill Purpose Claims based authorization for secure agent operations and access control. Claim Types Claim Description read Read file access write Write file access execute Command execution spawn Agent spawning memory Memory access network Network access admin Administrative operations Commands Check Claim Grant Claim Revoke Claim List Claims Scope Patterns Pattern Description All resources /src/ All files in src /config/ .toml TOML files in config memory:patterns Patterns namespace Security Levels Level Claims minimal read only standard read, write, execute elevated + spawn, memory admin all claims Best Practices 1. Follow principle of least privilege 2. Scope claims to specific resources 3. Audit claim usage regularly 4. Revoke claims when no longer needed Cross Host Work Claims (federation, v3.40.0+) Distinct from the authorization claims above: work claims coordinate ownership of a task or resource across agents, and now propagate across a cross host federation so a claim made on one node is visible to the whole swarm. Runtime tools (local ledger) Tool Purpose claims claim Take ownership of an issue/resource (with optional TTL). claims release Give up a claim you hold. claims handoff / claims accept handoff Transfer a claim to another agent. claims steal / claims mark stealable Work stealing for stalled claims. claims status / claims list Inspect current ownership. Federated (cross host) Publish claim events into a federation room ( federation bbs publish ) so ownership converges across hosts. Message types: ClaimIssued / ClaimReleased / ClaimHandoff / ClaimAck . Rules: one owner per resourceId ; first valid ClaimIssued wins (ties → earliest ts, then smallest from ); ClaimReleased or expired TTL frees it; ClaimHandoff only from the current owner; a coordinator posts ClaimAck naming the authoritative owner. Before shared work: claim, sync, and proceed only if you are the acknowledged owner. When a claim must be both cross host visible and runtime enforced, mirror the two — publish the federation claim message and call claims claim . See the cross host federation skill (ruflo bbs federation plugin) for the transport. Scoping a claim stream to a channel (ADR 386) By default every claim event lands in the shared swarm stream, where any relay member reads it. To keep a team's ownership ledger separate — or unreadable by the rest of the relay — publish claim messages into a channel instead: Reduction rules are unchanged; only the audience changes. Two caveats before relying on it: a private channel hides content but not metadata (the relay still sees who published and when), and a claim nobody outside the channel can read cannot arbitrate against a claim made outside it. If ownership must be swarm wide, keep it on the open stream. See the open federation skill for channel mechanics.