federation-status

Inspect federation health, peers, trust levels, and message metrics across installations.

70.1k|8.4k|Updated Jun 2, 2025
One-click install
npx skills add https://github.com/ruvnet/claude-flow --skill federation-status
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: federation-status
Source: https://github.com/ruvnet/claude-flow/tree/main/plugins/ruflo-federation/skills/federation-status
Command: npx skills add https://github.com/ruvnet/claude-flow --skill federation-status

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @claude-flow/plugin-agent-federation.

What problem does it solve?

When running agents across multiple installations, it is hard to know whether cross-installation connectivity is healthy, which peers are trusted, and how much traffic has flowed. This Skill consolidates that visibility into a single status report.

Core Features & Use Cases

  • Health Overview: Runs the federation status command to report overall health of the federation network.
  • Peer Inspection: Lists connected peers along with their trust levels and scores.
  • Metrics Summary: Summarizes active sessions, messages exchanged, PII redactions, and threat detections.
  • Use Case: You suspect an agent on another installation is not receiving messages. Run this Skill to check federation health, verify the peer's trust score, and review recent message metrics before debugging further.

Quick Start

Ask the assistant to show federation status and list current peers with their trust levels.

Frequently Asked Questions about federation-status

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I check federation status in claude-flow?

Run the federation status command via npx with the @claude-flow/plugin-agent-federation package to get overall health. This Skill automates that step and also lists peers and summarizes session and message metrics.

How do I list federation peers and their trust levels?

Use the ruflo-federation peers command from the agent-federation plugin, which lists each connected peer with its trust level and score. The Skill runs this automatically and presents the results in a summarized form.

What metrics does the federation status report include?

The report summarizes active sessions, messages exchanged between peers, PII redactions applied to traffic, and threat detections. It also covers peer trust levels and scores for each connected installation.

Can I search past federation history and peer trust data?

Yes, the Skill queries the ruflo memory_search MCP tool with the federation namespace to retrieve stored history about federation peers and trust. This complements the live status and peers commands.

Why does the federation status command fail to run?

The command requires npx to download and execute the @claude-flow/plugin-agent-federation package, so it fails without network access or a working Node.js environment. Verify npx is available and the package name resolves before retrying.