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:
- Calls
connection-listto find the staging site and itssite_id. - Reads the three pages with
sync-local-info, then runssync-auto-mapto match them to existing pages by title. - Shows you the mapping and which site will be overwritten, and waits for a yes.
- Starts the job with
sync-push-start, with a freshrequest_id, and setsacf_media_referenceswhen the pages have ACF image fields. - Polls
sync-job-statusuntil the job finishes, then checks the result on the target withsync-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_idonly 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.

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