kb-fediverse-relays

Explain ActivityPub relay protocols and subscription handshakes for Fediverse implementation.

9|Updated Mar 12, 2026
One-click install
npx skills add https://github.com/reiver/vibefed --skill kb-fediverse-relays
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: kb-fediverse-relays
Source: https://github.com/reiver/vibefed/tree/main/skills/kb-fediverse-relays
Command: npx skills add https://github.com/reiver/vibefed --skill kb-fediverse-relays

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps you understand and implement relays on the Fediverse, which are crucial for content discovery on new or small instances by rebroadcasting public content.

Core Features & Use Cases

  • Relay Mechanics: Explains how relays work at the ActivityPub level, including subscription handshakes and activity processing.
  • Protocol Differences: Details the Mastodon and LitePub/Pleroma relay protocols.
  • Implementation Guidance: Provides insights into building a relay and common pitfalls.
  • Use Case: If you're setting up a new Fediverse instance and your federated timeline is empty, this Skill will explain how to subscribe to a relay to populate it with content.

Quick Start

Explain how a new Fediverse instance can subscribe to a relay.

Frequently Asked Questions about kb-fediverse-relays

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

FAQPage Schema
How do I populate an empty federated timeline on a new Fediverse instance?

Fediverse relays work by accepting subscription handshakes from your instance and then rebroadcasting received public activities back to your server. This ensures continuous content delivery across the federated network.

How does an ActivityPub relay subscription handshake work?

An ActivityPub relay subscription handshake involves your instance sending a Follow activity to the relay actor. The relay then sends an Accept activity back, allowing the relay to forward public messages to your instance's federated timeline.

What is the difference between Mastodon and LitePub relay protocols?

The difference between Mastodon and LitePub relay protocols lies in their ActivityPub message processing and subscription mechanics. LitePub offers a distinct relay specification compared to Mastodon's implementation, affecting how instances handle relayed activities.

How do I implement a Fediverse relay for ActivityPub federation?

To implement a Fediverse relay, you must set up a relay actor to process subscription handshakes and handle incoming public activities. You must also decide whether to relay or forward messages to subscribed instances based on protocol differences.

When should I avoid using a Fediverse relay for content discovery?

You should avoid using a Fediverse relay for content discovery if your instance lacks the resources to process the high volume of incoming public messages. Relays continuously rebroadcast content, which can overwhelm small servers and impact federation performance.