fep

Retrieves Fediverse Enhancement Proposals and explains their implementation with Fedify APIs.

1.0k|132|Updated Mar 2, 2024
One-click install
npx skills add https://github.com/fedify-dev/fedify --skill fep
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: fep
Source: https://github.com/fedify-dev/fedify/tree/main/claude-plugin/skills/fep
Command: npx skills add https://github.com/fedify-dev/fedify --skill fep

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Developers building federated applications with Fedify often need to understand a specific Fediverse Enhancement Proposal (FEP) and map its requirements onto Fedify's APIs, which normally requires manually finding the proposal and translating its specification into implementation steps.

Core Features & Use Cases

  • FEP Lookup by ID: Accepts identifiers like FEP-8fcf or FEP-1b12, normalizes them to the bare four-character hex ID, and validates the format before retrieval.
  • Flexible Retrieval: Fetches the proposal via the fep MCP server when available, or falls back to cloning the official FEP repository from Codeberg and reading the proposal file directly.
  • Implementation Guidance: Summarizes the proposal's status, problem, and extensions, then explains relevant Fedify APIs such as @fedify/vocab vocabulary types, custom context handling, and dispatcher or inbox listener patterns.
  • Use Case: When you want to add support for a fediverse standard like FEP-8fcf (followers collection synchronization) to your Fedify app, ask for the FEP and receive both a summary of the spec and concrete Fedify implementation pointers.

Quick Start

Ask the assistant to look up FEP-8fcf and explain how to implement it in your Fedify application.

Frequently Asked Questions about fep

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

FAQPage Schema
How do I look up a Fediverse Enhancement Proposal by ID?

Provide the FEP identifier such as FEP-8fcf or just 8fcf, and the skill normalizes it to the bare four-character hex ID. It then retrieves the proposal via the fep MCP server or by cloning the official FEP repository from Codeberg.

How do I implement a FEP in a Fedify application?

After retrieving the proposal, the skill summarizes its status, problem, and extensions, then points to relevant Fedify APIs. These include vocabulary types in @fedify/vocab, custom JSON-LD context handling, and dispatcher or inbox listener patterns.

What FEP identifier formats are accepted?

Identifiers with or without the FEP- prefix are accepted, in any letter case. After normalization the result must match a four-character lowercase hex string, otherwise the skill asks you to provide a valid identifier.

Does FEP lookup work without the fep MCP server?

Yes, the skill falls back to cloning the fediverse/fep repository from Codeberg into a temporary directory and reading the proposal markdown file directly. Subsequent runs pull updates instead of re-cloning.

What information does the FEP summary include?

The summary covers the proposal's status, the problem it solves, and the extensions it defines. Extensions include new JSON-LD terms, HTTP endpoints, or activity shapes relevant to implementation.