Agent skill

Integrations

by Automattic in Automattic/wordpress-activitypub

Third-party WordPress plugin integration patterns. An agent skill from Automattic/wordpress-activitypub.

Install Integrations

skills CLI

$ npx skills add Automattic/wordpress-activitypub --skill integrations -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI

$ gh skill install Automattic/wordpress-activitypub integrations --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy

$ git clone --depth 1 https://github.com/Automattic/wordpress-activitypub.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/integrations .claude/skills/integrations && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Paste into Claude Code

Install the "integrations" agent skill from https://github.com/Automattic/wordpress-activitypub/tree/trunk/.agents/skills/integrations into .claude/skills/integrations/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "integrations", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

$skill-installer

$skill-installer install https://github.com/Automattic/wordpress-activitypub/tree/trunk/.agents/skills/integrations

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add Automattic/wordpress-activitypub --skill integrations -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install Automattic/wordpress-activitypub integrations --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/Automattic/wordpress-activitypub.git skills-src && mkdir -p .agents/skills && cp -r skills-src/.agents/skills/integrations .agents/skills/integrations && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "integrations" agent skill from https://github.com/Automattic/wordpress-activitypub/tree/trunk/.agents/skills/integrations into .agents/skills/integrations/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "integrations", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add Automattic/wordpress-activitypub --skill integrations -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install Automattic/wordpress-activitypub integrations --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/Automattic/wordpress-activitypub.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/.agents/skills/integrations .cursor/skills/integrations && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "integrations" agent skill from https://github.com/Automattic/wordpress-activitypub/tree/trunk/.agents/skills/integrations into .cursor/skills/integrations/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "integrations", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

gemini skills install

$ gemini skills install https://github.com/Automattic/wordpress-activitypub.git --path .agents/skills/integrations

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add Automattic/wordpress-activitypub --skill integrations -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install Automattic/wordpress-activitypub integrations --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/Automattic/wordpress-activitypub.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/.agents/skills/integrations .gemini/skills/integrations && rm -rf skills-src

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "integrations" agent skill from https://github.com/Automattic/wordpress-activitypub/tree/trunk/.agents/skills/integrations into .gemini/skills/integrations/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "integrations", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install Automattic/wordpress-activitypub integrations

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add Automattic/wordpress-activitypub --skill integrations -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/Automattic/wordpress-activitypub.git skills-src && mkdir -p .github/skills && cp -r skills-src/.agents/skills/integrations .github/skills/integrations && rm -rf skills-src

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "integrations" agent skill from https://github.com/Automattic/wordpress-activitypub/tree/trunk/.agents/skills/integrations into .github/skills/integrations/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "integrations", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add Automattic/wordpress-activitypub --skill integrations -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install Automattic/wordpress-activitypub integrations --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/Automattic/wordpress-activitypub.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/.agents/skills/integrations .opencode/skills/integrations && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "integrations" agent skill from https://github.com/Automattic/wordpress-activitypub/tree/trunk/.agents/skills/integrations into .opencode/skills/integrations/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "integrations", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: integrations
GitHub stars: 582
Token cost: ~1.4k tokens
SKILL.md length: 312 words
Files: 1
Skills in repo: 7
Repo updated: Oct 7, 2026
First seen: Oct 7, 2026
Licence: MIT

At a glance

Third-party WordPress plugin integration patterns. An agent skill from Automattic/wordpress-activitypub.

Works in 5 steps: Install target plugin → Activate ActivityPub → Check for conflicts → …
Adding new integrations
SKILL.md covers Quick Reference, Creating New Integration, Integration Patterns and Testing Integrations, plus 2 more sections
Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Integrations is an agent skill from Automattic/wordpress-activitypub. Third-party WordPress plugin integration patterns. Use when adding new integrations, debugging compatibility with other plugins, or working with existing integrations.

Its SKILL.md is about 1.4k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Backend & APIs, covering Third-party API integration. It works with WordPress and PHP. The repository describes itself as: The ActivityPub plugin connects your WordPress site to the Fediverse. Your site becomes a profile people can follow from Mastodon, and every post you publish is automatically… The licence is MIT.

When your agent uses it

Adding new integrations
Debugging compatibility with other plugins
Working with existing integrations

Example prompts

“/integrations”

Workflow steps

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

Install target plugin
Activate ActivityPub
Check for conflicts
Verify custom post types federate
Test federation of plugin content

What it can do on your machine

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

Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
No scripts in the folder and no shell commands in SKILL.md (its code samples are php).
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Integrations loads about 1.4k tokens when it runs. Until then it costs about 45 tokens; SKILL.md has 312 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it: ~45
When it runs · the whole SKILL.md, loaded when a task matches: ~1.4k

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

Auto-check passed

The automated check found no risky patterns in SKILL.md.

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 Automattic/wordpress-activitypub at commit 72d53bc, republished under its MIT licence (© Automattic). 312 words, ~1,405 tokens.

Download SKILL.mdSave it as .claude/skills/integrations/SKILL.md (or your agent's skills folder).

name: integrations
description: Third-party WordPress plugin integration patterns. Use when adding new integrations, debugging compatibility with other plugins, or working with existing integrations.

ActivityPub Integrations

This skill provides guidance on integrating the ActivityPub plugin with other WordPress plugins.

Quick Reference

Integration Location

All integrations live in the integration/ directory.

File naming: class-{plugin-name}.php (following PHP conventions in AGENTS.md)

Namespace: Activitypub\Integration

How Integrations Load

Integrations are wired up in integration/load.php inside plugin_init(). Each one is guarded by a detection check and then calls its class's static init():

php

// integration/load.php
if ( \defined( 'JETPACK__VERSION' ) ) {
    Jetpack::init();
}

Existing Integrations

The real integrations shipped today (see integration/):

akismet, buddypress, classic-editor, enable-mastodon-apps, jetpack, litespeed-cache, multisite-language-switcher, nodeinfo, opengraph, podlove-podcast-publisher, seriously-simple-podcasting, surge, webfinger, wpml, yoast-seo.

A few examples:

Akismet — runs inbound comments/interactions through Akismet spam checks.
OpenGraph — adds fediverse:creator and related metadata via the OpenGraph plugin.
Enable Mastodon Apps — lets Mastodon client apps talk to the site.
Caches (LiteSpeed Cache, Surge) — keep ActivityPub responses cacheable/uncached correctly.
Multilingual (WPML, Multisite Language Switcher) — language-aware actor and content handling.

For complete directory structure and naming conventions, see docs/php-class-structure.md.

Creating New Integration

Basic Integration Class

php

<?php
namespace Activitypub\Integration;

class Plugin_Name {
    /**
     * Initialize the class, registering WordPress hooks.
     */
    public static function init() {
        // Enable federation for the plugin's post type.
        \add_post_type_support( 'plugin_post_type', 'activitypub' );

        // Provide a custom transformer if the default Post transformer is not enough.
        \add_filter( 'activitypub_transformer', array( self::class, 'transformer' ), 10, 3 );
    }

    /**
     * Return a custom transformer for the plugin's objects.
     *
     * @param mixed  $transformer  The transformer to use. Default null.
     * @param mixed  $data         The object to transform.
     * @param string $object_class The class of the object to transform.
     * @return mixed
     */
    public static function transformer( $transformer, $data, $object_class ) {
        if ( 'WP_Post' === $object_class && 'plugin_post_type' === $data->post_type ) {
            require_once __DIR__ . '/class-custom-transformer.php';
            return new Custom_Transformer( $data );
        }
        return $transformer;
    }
}

Then register it in integration/load.php:

php

if ( \defined( 'PLUGIN_VERSION' ) ) {
    Plugin_Name::init();
}

Integration Patterns

Enabling Federation for a Post Type

Post-type support drives which content federates. Use add_post_type_support() — there is no activitypub_post_types filter:

php

\add_post_type_support( 'event', 'activitypub' );
\add_post_type_support( 'product', 'activitypub' );

The enabled post types are stored in the activitypub_support_post_types option (read with \get_option( 'activitypub_support_post_types', array( 'post' ) )).

Custom Transformers

The activitypub_transformer filter takes three arguments — ( $transformer, $data, $object_class ) — and is registered with priority 10, 3:

php

\add_filter( 'activitypub_transformer', function ( $transformer, $data, $object_class ) {
    if ( 'WP_Post' === $object_class && 'event' === $data->post_type ) {
        return new Event_Transformer( $data );
    }
    return $transformer;
}, 10, 3 );

Modifying the Activity Object

To tweak the final ActivityStreams array, hook activitypub_activity_object_array — ( $array, $class, $id, $object ):

php

\add_filter( 'activitypub_activity_object_array', function ( $array, $class, $id, $object ) {
    if ( isset( $array['type'] ) && 'Note' === $array['type'] ) {
        // Adjust the outgoing object array here.
    }
    return $array;
}, 10, 4 );

Testing Integrations

Verify Integration Loading

php

// Check if integration is active.
if ( \class_exists( '\Activitypub\Integration\Plugin_Name' ) ) {
    // Integration loaded.
}

Test Compatibility

Install target plugin
Activate ActivityPub
Check for conflicts
Verify custom post types federate
Test federation of plugin content

Common Integration Issues

Plugin Detection

php

// Multiple detection methods (match how integration/load.php guards each one).
if ( \defined( 'PLUGIN_VERSION' ) ) { }
if ( \function_exists( 'plugin_function' ) ) { }
if ( \class_exists( 'Plugin_Class' ) ) { }

Hook Priority

php

// Use appropriate priority.
\add_filter( 'hook', 'callback', 20 ); // After plugin's filter.

Namespace Conflicts

php

// Use fully qualified names.
$object = new \Plugin\Namespace\Class();

Best Practices

Always guard the integration with a detection check in integration/load.php before calling init().
Use late priority for filters when you need to override another plugin's defaults.
Test with multiple plugin versions.
Document compatibility requirements.
Handle plugin deactivation gracefully.

Files

Just SKILL.md in .agents/skills/integrations of Automattic/wordpress-activitypub.

Open the folder on GitHubat commit 72d53bc

Compare with similar skills

Integrations next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Integrations compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Integrations this skillAutomattic/wordpress-activitypub	582	—	~1.4k	Automated safety check: Pass	MIT	today
Wp Plugin Developmentjorgerosal/wordpress-skills	101	—	~12k	Automated safety check: Pass	MIT	4 mo ago
WooCommerce Email Editor Developmentwoocommerce/woocommerce	11k	—	~893	Automated safety check: Pass	Custom licence	today
Discord Php Bot Securitydiscord-php/DiscordPHP	1.1k	—	~1.2k	Automated safety check: Notes	MIT	yesterday
WooCommerce Backend Conventionswoocommerce/woocommerce	11k	1 repos	~614	Automated safety check: Pass	Custom licence	today
Passport Developmenttrypostit/trypost	678	—	~1.9k	Automated safety check: Pass	MIT	today

Similar skills

Wp Plugin Development
jorgerosal/wordpress-skills
WordPress plugin architecture review and WordPress.org submission standards.
101 GitHub stars~12k tokensUpdated 4 mo ago
Frontend & DesignAuto-check passed
WooCommerce Email Editor Development
woocommerce/woocommerce
Sets up a local environment for the WooCommerce block email editor, with a watcher, Mailpit email capture and build and test commands for its PHP and JS packages.
11k GitHub stars~893 tokensUpdated today
Backend & APIsAuto-check passed
Discord Php Bot Security
discord-php/DiscordPHP
Audit checklist for DiscordPHP bots and API libraries — stop the bot token leaking to third-party APIs or logs, keep secrets out of customids and exception messages, use constant-time comparison and…
1.1k GitHub stars~1.2k tokensUpdated yesterday
Backend & APIsAuto-check: notes
WooCommerce Backend Conventions
woocommerce/woocommerce
Guides agents writing or changing WooCommerce backend PHP so new classes, hooks and unit tests follow the project's conventions.
11k GitHub starsUsed in 1 repo~614 tokens
DevelopmentAuto-check passed
Passport Development
trypostit/trypost
Develops OAuth2 API authentication with Laravel Passport. An agent skill from trypostit/trypost.
678 GitHub stars~1.9k tokensUpdated today
Backend & APIsAuto-check passed
WooCommerce Store API Routes
woocommerce/woocommerce
Guidelines for adding or changing routes in the WooCommerce Store API under /wc/store/v1, covering authentication, REST design, schemas and variations.
11k GitHub stars~932 tokensUpdated today
Backend & APIsAuto-check passed

More from Automattic/wordpress-activitypub

Code Style
Automattic/wordpress-activitypub
PHP coding standards and WordPress patterns for ActivityPub plugin.
582 GitHub stars~2.2k tokensUpdated today
Auto-check passed
Dev
Automattic/wordpress-activitypub
Development workflows for WordPress ActivityPub plugin including wp-env setup, testing commands, linting, and build processes.
582 GitHub stars~1.1k tokensUpdated today
Auto-check passed
Federation
Automattic/wordpress-activitypub
ActivityPub protocol specification and federation concepts. An agent skill from Automattic/wordpress-activitypub.
582 GitHub stars~2.5k tokensUpdated today
Auto-check passed
Gitattributes
Automattic/wordpress-activitypub
A skill your agent uses when auditing or updating .gitattributes export-ignore coverage so dev-only files (lint configs, CI, tests, docs, build tooling) don't ship in the WordPress.org plugin zip.
582 GitHub stars~1.1k tokensUpdated today
Auto-check passed
Release
Automattic/wordpress-activitypub
Version management and release processes using Jetpack Changelogger.
582 GitHub stars~1.3k tokensUpdated today
Auto-check passed
PR
Automattic/wordpress-activitypub
INVOKE THIS SKILL before creating any PR to ensure compliance with branch naming, changelog requirements, and reviewer assignment.
582 GitHub stars~927 tokensUpdated today
Auto-check passed

Works with

Questions about Integrations

What does Integrations do?

Third-party WordPress plugin integration patterns. An agent skill from Automattic/wordpress-activitypub. Integrations is an agent skill from Automattic/wordpress-activitypub. Third-party WordPress plugin integration patterns.

When should I use Integrations?

Integrations fits situations like: adding new integrations; debugging compatibility with other plugins; working with existing integrations.

How do I install Integrations in Claude Code?

Run `npx skills add Automattic/wordpress-activitypub --skill integrations -a claude-code`. Or copy the skill folder (.agents/skills/integrations in Automattic/wordpress-activitypub) into .claude/skills/integrations in your project. Claude Code loads it when a task matches its description.

How do I install Integrations in Codex?

Run `npx skills add Automattic/wordpress-activitypub --skill integrations -a codex`. Or copy the skill folder (.agents/skills/integrations in Automattic/wordpress-activitypub) into .agents/skills/integrations in your project. Codex loads it when a task matches its description.

Can I use Integrations in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add Automattic/wordpress-activitypub --skill integrations -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/integrations, .gemini/skills/integrations, .github/skills/integrations and .opencode/skills/integrations in your project.

What does Integrations need to run?

SKILL.md names no scripts, command-line tools or credentials: Integrations is instructions for the agent only.

Does Integrations access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Integrations safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Integrations use?

Integrations is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Integrations use?

About 1.4k tokens (SKILL.md is roughly 5.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Integrations?

Skills that share tags, products or a category with Integrations: Wp Plugin Development (jorgerosal/wordpress-skills, 101 stars), WooCommerce Email Editor Development (woocommerce/woocommerce, 11k stars), Discord Php Bot Security (discord-php/DiscordPHP, 1.1k stars) and WooCommerce Backend Conventions (woocommerce/woocommerce, 11k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Integrations?

Automattic (a GitHub organization) maintains it in Automattic/wordpress-activitypub, which has 582 GitHub stars. The repository holds 7 skills in this directory. The repository was last updated on October 7, 2026.

Source: Automattic/wordpress-activitypub on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.

Install Integrations

Facts

At a glance

What it does

When your agent uses it

Example prompts

Workflow steps

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

ActivityPub Integrations

Quick Reference

Integration Location

How Integrations Load

Existing Integrations

Creating New Integration

Basic Integration Class

Integration Patterns

Enabling Federation for a Post Type

Custom Transformers

Modifying the Activity Object

Testing Integrations

Verify Integration Loading

Test Compatibility

Common Integration Issues

Plugin Detection

Hook Priority

Namespace Conflicts

Best Practices

Files

Compare with similar skills

Similar skills

More from Automattic/wordpress-activitypub

Related

Questions about Integrations