claude-plugin/skills/actor/SKILL.md
Guide the user through implementing an ActivityPub actor with Fedify. Use when the user needs to add or configure an actor dispatcher, set up key pairs, configure aliases, or handle actor-related requests.
npx skillsauth add fedify-dev/fedify actorInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Help the user implement an ActivityPub actor using Fedify.
Walk through:
setActorDispatcher(path, handler) on the Federation
object or FederationBuilder, including the {identifier} path
parameter.Person, Service, or other Actor vocabulary object
with the required fields (id, inbox, publicKey, etc.)..setKeyPairsDispatcher() to supply RSA and Ed25519 keys.mapActorAlias() for handle-based or
fixed-path aliases./.well-known/webfinger automatically once the actor dispatcher
is registered.Reference: https://fedify.dev/manual/actor
development
Help the user migrate Fedify code between versions. Use when the user needs to upgrade their Fedify version, fix breaking-change errors, or update deprecated API usage.
tools
Help the user set up Fedify inbox listeners for handling incoming ActivityPub activities. Use when the user needs to handle Follow, Like, Announce, Create, Undo, or other activity types delivered to their inbox.
testing
Look up a Fediverse Enhancement Proposal (FEP) and explain how to implement it with Fedify. Use when the user asks about a specific FEP by ID (e.g., FEP-8fcf, FEP-1b12) or wants to implement a fediverse standard in their Fedify application.
tools
Use this skill whenever writing JavaScript or TypeScript code that uses Fedify to build an ActivityPub server, handle federation activities, implement fediverse features, or integrate Fedify with a web framework such as Hono, Express, Next.js, Nuxt, Fastify, Koa, NestJS, Astro, SvelteKit, Fresh, h3, Elysia, or Cloudflare Workers. Covers the `Federation` builder pattern, actor/inbox/outbox/collection dispatchers, inbox listeners, vocabulary objects from `@fedify/vocab`, key pair management, HTTP Signatures, Object Integrity Proofs, the `KvStore` and `MessageQueue` interfaces, database adapter packages, structured logging with LogTape, OpenTelemetry tracing, the `fedify` CLI toolchain, and common mistakes. Also apply when the user mentions ActivityPub, federation, fediverse, WebFinger, NodeInfo, FEPs, or Mastodon interoperability, even if they do not name Fedify explicitly.