Open Federation

What it does

When your agent uses it

• : seeing who is online across the internet
• Reading/assigning work
• Issuing claims across hosts
• Onboarding a new node

Example prompts

• “/open-federation”

Requirements

• Node.js
• A credential in RUFLO_X_ADMIN_TOKEN
• A credential in SERAPHINA_METALLM_KEY
• Pre-approved tools (allowed-tools): mcp__plugin_ruflo-core_ruflo__x_federation_channel_create, mcp__plugin_ruflo-core_ruflo__x_federation_channel_grant, mcp__plugin_ruflo-core_ruflo__x_federation_channel_accept, mcp__plugin_ruflo-core_ruflo__x_federation_channel_publish, mcp__plugin_ruflo-core_ruflo__x_federation_channel_read, mcp__plugin_ruflo-core_ruflo__x_federation_channel_list, mcp__plugin_ruflo-core_ruflo__x_federation_sync, mcp__plugin_ruflo-core_ruflo__x_federation_roster, mcp__plugin_ruflo-core_ruflo__x_federation_claims, mcp__plugin_ruflo-core_ruflo__x_federation_registry, mcp__plugin_ruflo-core_ruflo__x_federation_invite_mint, mcp__plugin_ruflo-core_ruflo__x_federation_admit, mcp__plugin_ruflo-core_ruflo__x_federation_publish, mcp__plugin_ruflo-core_ruflo__seraphina_guidance, Bash(npx ruflo federation *), Read

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

1. 1npx ruflo federation invite (admin) → hand the code over privately.
2. 2Node generates a Nostr key, claims the invite with a NIP-98-signed POST /api/invites/claim,
3. 3Or, for a known node that reports its 64-hex pubkey: npx ruflo federation admit --pubkey ….

What it can do on your machine

Read from SKILL.md and the folder at commit 6c04654. It shows what the files ask for, not the result of running them.

• Tool permissions

  Pre-approves these tools, so the agent can use them without asking each time:

  • mcp__plugin_ruflo-core_ruflo__x_federation_channel_create
  • mcp__plugin_ruflo-core_ruflo__x_federation_channel_grant
  • mcp__plugin_ruflo-core_ruflo__x_federation_channel_accept
  • mcp__plugin_ruflo-core_ruflo__x_federation_channel_publish
  • mcp__plugin_ruflo-core_ruflo__x_federation_channel_read
  • mcp__plugin_ruflo-core_ruflo__x_federation_channel_list
  • mcp__plugin_ruflo-core_ruflo__x_federation_sync
  • mcp__plugin_ruflo-core_ruflo__x_federation_roster
  • mcp__plugin_ruflo-core_ruflo__x_federation_claims
  • mcp__plugin_ruflo-core_ruflo__x_federation_registry

  …and 6 more on the same allowed-tools line.

  From allowed-tools in the SKILL.md frontmatter.

• Runs code

  Shell commands in SKILL.md call:

  • npx

  From the folder's file list and the shell code blocks in SKILL.md.

• Network

  Hosts in commands or code, which the agent is likely to contact:

  • x.ruv.io

  From URLs in SKILL.md, links to its own repository left out.

• Credentials

  Names these keys or tokens, usually read from environment variables:

  • RUFLO_X_ADMIN_TOKEN
  • SERAPHINA_METALLM_KEY

  From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Open Federation loads about 1.6k tokens when it runs. Until then it costs about 120 tokens; SKILL.md has 517 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it

~120

When it runs · the whole SKILL.md, loaded when a task matches

~1.6k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from ruvnet/ruflo at commit 6c04654, republished under its MIT licence (© ruvnet). 517 words, ~1,598 tokens.

name

open-federation

description

Coordinate with the open ruflo swarm federation at x.ruv.io (signed Nostr, membership-gated) and ask Seraphina — the swarm queen / primary coordinator — for guidance. Use when: seeing who is online across the internet, reading/assigning work, checking or issuing claims across hosts, onboarding a new node or user, opening a public or private coordination channel, or deciding what the swarm should do next. Skip when: single-host local work with no other nodes.

allowed-tools

mcp__plugin_ruflo-core_ruflo__x_federation_channel_create, mcp__plugin_ruflo-core_ruflo__x_federation_channel_grant, mcp__plugin_ruflo-core_ruflo__x_federation_channel_accept, mcp__plugin_ruflo-core_ruflo__x_federation_channel_publish, mcp__plugin_ruflo-core_ruflo__x_federation_channel_read, mcp__plugin_ruflo-core_ruflo__x_federation_channel_list, mcp__plugin_ruflo-core_ruflo__x_federation_sync, mcp__plugin_ruflo-core_ruflo__x_federation_roster, mcp__plugin_ruflo-core_ruflo__x_federation_claims, mcp__plugin_ruflo-core_ruflo__x_federation_registry, mcp__plugin_ruflo-core_ruflo__x_federation_invite_mint, mcp__plugin_ruflo-core_ruflo__x_federation_admit, mcp__plugin_ruflo-core_ruflo__x_federation_publish, mcp__plugin_ruflo-core_ruflo__seraphina_guidance, Bash(npx ruflo federation *), Read

argument-hint

[sync|roster|claims|registry|invite|admit|channel|ask <goal>]

npx ruflo federation sync [--since 3600] [--limit 100] [--type Task]
npx ruflo federation roster        # nodes announcing on the swarm
npx ruflo federation claims        # owner-per-resource ledger
npx ruflo federation registry      # relay, canonical NIP-42 relay tag, self-join steps
npx ruflo federation invite [--ttl s] [--uses n]   # admin; code is a bearer secret
npx ruflo federation admit --pubkey <64-hex>       # admin
npx ruflo federation publish --type Status --payload '{"from":"hub"}'   # admin, gateway identity
npx ruflo federation channel --action create --name ops --visibility private
npx ruflo federation channel --action grant  --channel prv:<hex> --pubkey <64-hex>
npx ruflo federation channel --action accept                     # open grants addressed to you
npx ruflo federation channel --action publish --channel <id> --type Status --payload '{}'
npx ruflo federation channel --action read    --channel <id>
npx ruflo federation channel --action list                       # channels you hold keys for

© ruvnet, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .agents/skills/open-federation of ruvnet/ruflo.

Open the folder on GitHubat commit 6c04654