Agent skill

Wordpress Setup

by jezweb in jezweb/claude-skills

Connect to a WordPress site via WP-CLI over SSH or the REST API.

MITAuto-check: notesBackend & APIs

Install Wordpress Setup

skills CLI
$ npx skills add jezweb/claude-skills --skill wordpress-setup -a claude-code

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

GitHub CLI
$ gh skill install jezweb/claude-skills wordpress-setup --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/jezweb/claude-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/wordpress/skills/wordpress-setup .claude/skills/wordpress-setup && 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/

Facts

Skill name
wordpress-setup
GitHub stars
1.1k
Token cost
~1.1k tokens
SKILL.md length
337 words
Files
2 (incl. references)
Skills in repo
52
Repo updated
First seen
Licence
MIT

At a glance

Connect to a WordPress site via WP-CLI over SSH or the REST API.

  • Works in 5 steps: Check WP-CLI → Connect to the Site → Store Credentials → …
  • The user wants to connect to a WordPress site
  • SKILL.md covers Workflow, Critical Patterns and Reference Files
  • Calls curl, jq and ssh; reaches raw.githubusercontent.com; needs WP_APP_PASSWORD

What it does

Wordpress Setup is an agent skill from jezweb/claude-skills. Connect to a WordPress site via WP-CLI over SSH or the REST API. Check CLI, test SSH, set up auth, verify access, save config. Use whenever the user wants to connect to a WordPress site, set up WP-CLI access, create an Application Password, or troubleshoot WordPress connection / auth issues.

Its SKILL.md is about 1.1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including reference files (for example `references/wp-cli-essentials.md`). Compatibility notes: claude-code-only

It sits in Backend & APIs, covering REST APIs. It works with WordPress. The repository describes itself as: Skills for Claude Code CLI such as full stack dev Cloudflare, React, Tailwind v4, and AI integrations. The licence is MIT.

When your agent uses it

  • The user wants to connect to a WordPress site
  • Set up WP-CLI access
  • Create an Application Password
  • Troubleshoot WordPress connection / auth issues

Example prompts

  • “/wordpress-setup”

Requirements

  • Compatibility (from SKILL.md): claude-code-only

Workflow steps

5 steps, taken from the step headings in SKILL.md.

  1. Check WP-CLI
  2. Connect to the Site
  3. Store Credentials
  4. Verify Full Access
  5. Save Site Config

What it can do on your machine

Read from SKILL.md and the folder at commit 64965d9. 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

    Shell commands in SKILL.md call:

    • curl
    • jq
    • ssh

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • raw.githubusercontent.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • WP_APP_PASSWORD

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

  • Compatibility

    claude-code-only

    From compatibility in the SKILL.md frontmatter.

Context cost

Wordpress Setup loads about 1.1k tokens when it runs, and up to ~1.6k if it reads all its reference files. Until then it costs about 77 tokens; SKILL.md has 337 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~77
When it runs · the whole SKILL.md, loaded when a task matches
~1.1k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~1.6k

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: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NoteRuns commands with sudoSKILL.md:25
    sudo mv wp-cli.phar /usr/local/bin/wp

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 jezweb/claude-skills at commit 64965d9, republished under its MIT licence (© jezweb). 337 words, ~1,079 tokens.

Download SKILL.mdSave it as .claude/skills/wordpress-setup/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
wordpress-setup
description
Connect to a WordPress site via WP-CLI over SSH or the REST API. Check CLI, test SSH, set up auth, verify access, save config. Use whenever the user wants to connect to a WordPress site, set up WP-CLI access, create an Application Password, or troubleshoot WordPress connection / auth issues.
compatibility
claude-code-only

WordPress Setup

Connect to a WordPress site and verify working access via WP-CLI or REST API. Produces a verified connection config ready for content management and Elementor editing.

Workflow

Step 1: Check WP-CLI
bash
wp --version

If not installed, guide the user:

bash
# macOS/Linux
curl -O https://raw.githubusercontent.com/wp-cli/builds/gh-pages/phar/wp-cli.phar
chmod +x wp-cli.phar
sudo mv wp-cli.phar /usr/local/bin/wp

Also ensure the SSH extension is available (needed for remote sites):

bash
wp package install wp-cli/ssh-command
Step 2: Connect to the Site

Option A: WP-CLI over SSH (preferred)

bash
wp --ssh=user@hostname/path/to/wordpress option get siteurl

Common patterns:

  • Rocket.net: wp --ssh=user@hostname/www/sitename/public option get siteurl
  • cPanel: wp --ssh=user@hostname/public_html option get siteurl
  • Custom: Ask user for SSH user, host, and WordPress path

Test with a simple command first:

bash
wp --ssh=user@host/path core version

Option B: REST API with Application Password

If SSH isn't available:

  1. Navigate to https://example.com/wp-admin/profile.php (or use browser automation)
  2. Scroll to "Application Passwords" section
  3. Enter a name (e.g. "Claude Code") and click "Add New Application Password"
  4. Copy the generated password (spaces are part of it but optional in auth)

Test the connection:

bash
curl -s https://example.com/wp-json/wp/v2/posts?per_page=1 \
  -u "username:xxxx xxxx xxxx xxxx xxxx xxxx" | jq '.[0].title'
Step 3: Store Credentials

For WP-CLI SSH — create a wp-cli.yml in the project root:

yaml
ssh:
  sitename:
    cmd: ssh -o StrictHostKeyChecking=no %pseudotty% user@hostname %cmd%
    url: /path/to/wordpress

Then use: wp @sitename option get siteurl

For REST API — store in .dev.vars:

WP_SITE_URL=https://example.com
WP_USERNAME=admin
WP_APP_PASSWORD=xxxx xxxx xxxx xxxx xxxx xxxx

Ensure .dev.vars is in .gitignore. For cross-project use, store in your preferred secrets manager (environment variable, 1Password CLI, etc.).

Step 4: Verify Full Access

Run a comprehensive check:

bash
# Site info
wp @sitename option get siteurl
wp @sitename option get blogname

# Content access
wp @sitename post list --post_type=page --posts_per_page=5 --fields=ID,post_title,post_status

# Plugin status (check for Elementor)
wp @sitename plugin status elementor

# Theme info
wp @sitename theme status
Step 5: Save Site Config

Create wordpress.config.json for other skills to reference:

json
{
  "site": "example.com",
  "siteUrl": "https://example.com",
  "accessMethod": "ssh",
  "sshAlias": "sitename",
  "wpPath": "/path/to/wordpress",
  "hasElementor": true,
  "elementorVersion": "3.x.x"
}

Critical Patterns

SSH Connection Issues
SymptomFix
Permission denied (publickey)Check SSH key: ssh -v user@host
wp: command not found via SSHWP-CLI not in remote PATH — use full path: /usr/local/bin/wp
Error: This does not appear to be a WordPress installationWrong path — check wp-path argument
Timeout on large operationsAdd --ssh=user@host/path --allow-root or increase SSH timeout
WP-CLI Aliases

Define aliases in ~/.wp-cli/config.yml for frequently-accessed sites:

yaml
@client1:
  ssh: user@client1.example.com/www/public
@client2:
  ssh: user@client2.rocketcdn.me/www/client2/public

Then: wp @client1 post list

REST API Gotchas
  • Application passwords require HTTPS (won't work on HTTP)
  • Some security plugins block REST API — check for 401/403 responses
  • Caching plugins may serve stale REST responses — use ?_=${timestamp} cache buster
  • Custom post types need show_in_rest: true to appear in API

Reference Files

  • references/wp-cli-essentials.md — SSH alias patterns, common flags, and troubleshooting

© jezweb, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file (references) in plugins/wordpress/skills/wordpress-setup of jezweb/claude-skills.

  • SKILL.md
  • references/wp-cli-essentials.md

Open the folder on GitHubat commit 64965d9

Compare with similar skills

Wordpress Setup 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.

Wordpress Setup compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Wordpress Setup this skilljezweb/claude-skills1.1k—~1.1kAutomated safety check: NotesMIT
Wp Performancegambitph/Stackable3503 repos~1.5kAutomated safety check: PassGPL-3.0
WooCommerce Store API Routeswoocommerce/woocommerce11k—~932Automated safety check: PassCustom licence
Wordpress Routergambitph/Stackable3503 repos~554Automated safety check: PassGPL-3.0
Blog TaxonomyAgriciDaniel/claude-blog2.3k1 repos~2.5kAutomated safety check: PassMIT
Wp REST APIgambitph/Stackable3502 repos~1.2kAutomated safety check: PassGPL-3.0

Similar skills

  • Wp Performance

    gambitph/Stackable

    A skill your agent uses when investigating or improving WordPress performance (backend-only agent): profiling and measurement (WP-CLI profile/doctor, Server-Timing, Query Monitor via REST headers)…

    350 GitHub starsUsed in 3 repos~1.5k tokens
    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
  • Wordpress Router

    gambitph/Stackable

    A skill your agent uses when the user asks about WordPress codebases (plugins, themes, block themes, Gutenberg blocks, WP core checkouts) and you need to quickly classify the repo and route to the…

    350 GitHub starsUsed in 3 repos~554 tokens
    Backend & APIsAuto-check passed
  • Blog Taxonomy

    AgriciDaniel/claude-blog

    Extract, suggest, and sync tags and categories for blog posts across all major CMS platforms.

    2.3k GitHub starsUsed in 1 repo~2.5k tokens
    Backend & APIsAuto-check passed
  • Wp REST API

    gambitph/Stackable

    A skill your agent uses when building, extending, or debugging WordPress REST API endpoints/routes: registerrestroute, WPRESTController/controller classes, schema/argument validation…

    350 GitHub starsUsed in 2 repos~1.2k tokens
    Backend & APIsAuto-check passed
  • Wp REST API Development

    jorgerosal/wordpress-skills

    WordPress REST API review and development guidance. An agent skill from jorgerosal/wordpress-skills.

    100 GitHub stars~1.4k tokensUpdated 4 mo ago
    Backend & APIsAuto-check passed

More from jezweb/claude-skills

All 52 skills in this repo
  • Elevenlabs Agents

    jezweb/claude-skills

    Build conversational AI voice agents on the ElevenLabs platform.

    1.1k GitHub starsUsed in 1 repo~3.3k tokens
    Auto-check passed
  • Favicon Gen

    jezweb/claude-skills

    Generate custom favicons from logos, text, or brand colours.

    1.1k GitHub starsUsed in 1 repo~1k tokens
    Auto-check passed
  • Tailwind Theme Builder

    jezweb/claude-skills

    Set up Tailwind v4 + shadcn/ui themed UI with dark mode. An agent skill from jezweb/claude-skills.

    1.1k GitHub starsUsed in 1 repo~3.2k tokens
    Auto-check passed
  • Project Health

    jezweb/claude-skills

    All-in-one project configuration and health management. An agent skill from jezweb/claude-skills.

    1.1k GitHub starsUsed in 1 repo~3k tokens
    Auto-check passed
  • Responsiveness Check

    jezweb/claude-skills

    Test website responsiveness across viewport widths using browser automation.

    1.1k GitHub starsUsed in 1 repo~1.7k tokens
    Auto-check passed
  • MCP Builder

    jezweb/claude-skills

    Build MCP servers in Python with FastMCP. An agent skill from jezweb/claude-skills.

    1.1k GitHub stars~3.1k tokensUpdated 2 days ago
    Auto-check: notes

Works with

Categories

Questions about Wordpress Setup

What does Wordpress Setup do?

Connect to a WordPress site via WP-CLI over SSH or the REST API. Wordpress Setup is an agent skill from jezweb/claude-skills. Connect to a WordPress site via WP-CLI over SSH or the REST API.

When should I use Wordpress Setup?

Wordpress Setup fits situations like: the user wants to connect to a WordPress site; set up WP-CLI access; create an Application Password; troubleshoot WordPress connection / auth issues.

How do I install Wordpress Setup in Claude Code?

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

How do I install Wordpress Setup in Codex?

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

Can I use Wordpress Setup 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 jezweb/claude-skills --skill wordpress-setup -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/wordpress-setup, .gemini/skills/wordpress-setup, .github/skills/wordpress-setup and .opencode/skills/wordpress-setup in your project.

What does Wordpress Setup need to run?

Going by SKILL.md and its folder, Wordpress Setup needs the command-line tools its instructions call (curl, jq and ssh) and credentials named WP_APP_PASSWORD. Compatibility (from SKILL.md): claude-code-only.

Does Wordpress Setup access the network?

SKILL.md names 1 domain. In commands or code: raw.githubusercontent.com; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is Wordpress Setup safe to install?

Our automated static check of SKILL.md found notes only (runs commands with sudo), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Wordpress Setup use?

Wordpress Setup 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 Wordpress Setup use?

About 1.1k tokens (SKILL.md is roughly 4.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 539 tokens, read only when the agent opens those files.

What are the alternatives to Wordpress Setup?

Skills that share tags, products or a category with Wordpress Setup: Wp Performance (gambitph/Stackable, 350 stars), WooCommerce Store API Routes (woocommerce/woocommerce, 11k stars), Wordpress Router (gambitph/Stackable, 350 stars) and Blog Taxonomy (AgriciDaniel/claude-blog, 2.3k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Wordpress Setup?

jezweb (a GitHub user) maintains it in jezweb/claude-skills, which has 1,050 GitHub stars. The repository holds 52 skills in this directory. The repository was last updated on October 5, 2026.

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