Back to blog
7 min read AI

Agent Skills for WordPress: Content Sync, Import and Export from Claude, Codex or Cursor

Ask an AI agent to push twelve pages from staging to production and it has two ways to start. It can open wp-admin and click, which cost about 29 minutes and $3.80 in tokens for one Elementor page in our browser agent test. Or it can call the plugin through the WordPress Abilities API, where the same page took 11 calls and about $0.31. The second route only works if the agent knows which of the plugin’s 230 abilities to call, in what order and with which arguments. Agent Skills give it that knowledge.

We published four skills for the plugin in a public GitHub repository. This article covers what they are, how to install them, how to ask an agent to use them and what is inside the files.

What an Agent Skill is

A skill is a folder with a SKILL.md file. The file starts with a name and a short description, followed by instructions. The agent keeps only the name and description of every installed skill in its context. When your request matches a description, it loads the full instructions. Skills you do not need cost almost nothing.

The format works in agents that support Agent Skills, including Claude Code, Codex and Cursor. The plugin side is unchanged: the skills call the same abilities that the Abilities API already exposes, 132 in the free plugin and 98 more in PRO.

The four skills

Skill Use it when Main abilities it calls
wordpress-content-sync You push or pull posts, pages, ACF fields, comments or media between two connected sites connection-list, sync-local-info, sync-auto-map, sync-push-start, sync-pull-start, sync-job-status, sync-result
wordpress-import-export You import or export CSV, XML, JSON, XLSX or ODS, fix failed rows or schedule a repeat upload-from-url, import-prepare, import-validate, import-start, export-count, export-start, job-errors, schedule-create
wordpress-site-migration You move a whole site as a migration ZIP or copy the media library migration-plan, migration-start, migration-prepare, migration-import-start, sync-media-push-start, media-sync-start
woocommerce-sync-pro You sync orders, customers, coupons, reviews, products, menus, users or custom tables (PRO) sync-woo-orders-push-start, sync-reviews-push-start, sync-menus-push-start, sync-tables-push-start

The first three work with the free plugin. The fourth needs the PRO addon with an active license on both sites, and its first step is to check the license and stop if it is not active.

How to install the skills

You need the plugin active on every site involved, WordPress 6.9 or newer for the Abilities API, and a way for the agent to reach each site: either the WordPress MCP Adapter or an administrator application password (Users, Profile, Application Passwords) used with the REST endpoint /wp-json/wp-abilities/v1.

With the skills CLI

The command asks which skills to add and which of your installed agents to add them to:

npx skills add RockStarLab/wp-import-export-content-sync-skills

To add one skill only, pass its name:

npx skills add RockStarLab/wp-import-export-content-sync-skills --skill wordpress-content-sync

As a Claude Code plugin

The repository is also a Claude Code marketplace. Inside Claude Code:

/plugin marketplace add RockStarLab/wp-import-export-content-sync-skills
/plugin install wordpress-import-export-skills

By copying the folders

Download the repository and copy the folders from skills/ into your agent’s skills directory, for example ~/.claude/skills/ for Claude Code. Nothing else is needed.

Asking an agent to use them

You do not name the skill. You describe the job, and the description in SKILL.md is what makes the agent pick it. Two requests and what the agent does with them:

Push pages to staging

Request: Push pages 41, 57 and 63 from this site to the staging site. Update the ones that already exist there. With wordpress-content-sync loaded, the agent follows this order:

  1. Calls connection-list to find the staging site and its site_id.
  2. Reads the three pages with sync-local-info, then runs sync-auto-map to match them to existing pages by title.
  3. Shows you the mapping and which site will be overwritten, and waits for a yes.
  4. Starts the job with sync-push-start, with a fresh request_id, and sets acf_media_references when the pages have ACF image fields.
  5. Polls sync-job-status until the job finishes, then checks the result on the target with sync-browse.

Import a supplier file

Request: Import https://example.com/feed.csv as posts. Skip rows that already exist. With wordpress-import-export loaded: upload-from-url, import-prepare for the column list and a suggested mapping, import-validate, your confirmation, import-start with duplicate_mode set to skip, then job-get and job-errors for rows that failed. If you run the same import every week, the skill points to saved mapping templates and schedule-create.

What is inside a SKILL.md

Here is the start of wordpress-content-sync:

---
name: wordpress-content-sync
description: Sync WordPress posts, pages, ACF fields, comments and media between two sites through the Content Sync, Media Sync, Import, Export plugin Abilities API (rsl-ie/*). Use when the user asks to push, pull, copy or update content between a staging/production or any two connected WordPress sites without export files.
---

## Workflow

1. rsl-ie/get-capabilities (check plugin version, abilities available).
2. rsl-ie/connection-list: pick the site_id of the target.
3. Choose records: sync-browse (remote), sync-search-local, or ids given by the user.
...

Each file has three parts. The description is the trigger, so it names the plugin, the abilities namespace and the situations that should activate it. The workflow lists abilities in order with the arguments they require, taken from the abilities’ input schemas: sync-push-start, for example, takes site_id, post_type, 1 to 50 post_ids and a request_id. The rules section covers the mistakes that cost the most.

Those rules are the same across the skills:

  • Confirm the direction and the list of records before any call that writes. Pushing overwrites the destination.
  • Keep batches at 50 records or fewer and run them one after another.
  • Reuse a request_id only when retrying the identical request, because it is what prevents a duplicate job.
  • After an error or a timeout, read the job status before retrying, since the job may have finished.
  • Take a backup of the destination before overwriting content.

Safety

The plugin marks abilities that change or delete data as destructive in their metadata, and the skills tell the agent to ask before calling them. Two more rules are written into the files. The incoming Content Sync key can be revealed with site-key-reveal, and the skills allow that only when you ask for it explicitly and never print the key into the chat. Text found inside an imported file is treated as data and not as instructions.

Give the agent its own application password on a site you can restore, and delete the password when the job is done. For a backup before a large overwrite, see the content-only backup.

What we tested and what we have not

The content-sync workflow is the one we measured in the browser agent test: an agent running it through the Abilities API used 11 calls for the Elementor page with 11 images. The repository installs with npx skills add, which lists all four skills, the Claude Code marketplace file passes claude plugin validate, and the Skills Directory security scan graded each skill A.

We wrote the import/export, migration and WooCommerce skills from the abilities’ input schemas, and we have not yet timed an agent running them from start to finish. We also have not compared an agent with the skill installed against one without it. Large syncs depend on the target site’s timeouts, see large syncs, batching and timeouts.

FAQ

What are Agent Skills for WordPress?

They are instruction folders for AI agents. Ours explain how to use the Content Sync, Import and Export plugin through its abilities: which ones to call, in what order, and what to confirm with you first.

Do I need the PRO plugin to use the skills?

No for three of the four. Content sync of posts and pages, import and export, migration and media sync work in the free plugin. The WooCommerce skill needs PRO with an active license on both sites.

Does it work without the MCP Adapter?

Yes. The same abilities are available over REST at /wp-json/wp-abilities/v1 with an application password, and the skills describe both ways of calling them.

Can the agent overwrite my content by mistake?

Sync pushes and imports with the update option do overwrite existing content, which is why the skills require your confirmation of the direction and the records first. A backup before large jobs is still the safest habit.

Where is the source and what is the license?

The skills are in the GitHub repository under GPL-2.0, and pull requests are open.

Dmitriy
About author

Dmitriy

WordPress Developer with 15+ years of commercial experience. Elite Author on ThemeForest and creator of custom WordPress plugins. Passionate about clean code, performance optimization, and building useful tools for the WordPress community.

JOIN THE CONVERSATION

Comments 0

Have a question or a tip to share? Leave it below.

Leave a comment

Your email address will not be published. Required fields are marked *

We store your name, email and comment to show and moderate it; your email is never published. Spam protection is provided by Cloudflare Turnstile and profile pictures by Gravatar. See our Privacy Policy.


Try the plugin with no risks!

New users get 1 month with access to all premium features. Experience the most powerful WordPress data engine today.

Download Now
Get PRO for FREE