WordPress Admin Skill

Complete WordPress site management via WP-CLI (local Docker) and REST API (production sites).

When to Use This Skill

Invoke this skill when you need to:

Create pages or posts in WordPress
Set up SEO (focus keyword, meta description, title)
Upload and manage media/images
Configure WordPress settings
Check or recommend plugins
Manage the local WordPress Docker environment

Available Sites

CSR Development (Production)

Site URL: https://csrdevelopment.com
REST API: https://csrdevelopment.com/wp-json/wp/v2
FTP Host: ftp.csrdevelopment.com
FTP User: alfonso@csrdevelopment.com
Theme Path: /wp-content/themes/csr-theme
Local Files: /root/csrdevelopment.com/csrdevelopment.com/public_html

Local WordPress (Docker)

Site URL: https://local2.hustletogether.com
Container: wordpress-local-wordpress-1
WP-CLI: docker exec wordpress-local-wordpress-1 wp <command> --allow-root
Admin: https://local2.hustletogether.com/wp-admin
Credentials: admin / admin123

Workflows

Create a Page

Local (Docker):

bash

docker exec wordpress-local-wordpress-1 wp post create \
  --post_type=page \
  --post_title="Privacy Policy" \
  --post_name="privacy-policy" \
  --post_status="publish" \
  --allow-root

Production (REST API):

bash

curl -X POST "https://csrdevelopment.com/wp-json/wp/v2/pages" \
  -H "Authorization: Basic BASE64_CREDENTIALS" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Privacy Policy",
    "slug": "privacy-policy",
    "status": "publish",
    "template": "page-privacy-policy.php"
  }'

Set Page Template

bash

docker exec wordpress-local-wordpress-1 wp post meta update <POST_ID> _wp_page_template "page-privacy-policy.php" --allow-root

Configure SEO (Yoast)

Requirements: Theme must have Yoast meta fields registered (see functions.php snippet below)

bash

# Set focus keyphrase
docker exec wordpress-local-wordpress-1 wp post meta update <POST_ID> _yoast_wpseo_focuskw "privacy policy miami real estate" --allow-root

# Set meta description (155 chars max, include focus keyword)
docker exec wordpress-local-wordpress-1 wp post meta update <POST_ID> _yoast_wpseo_metadesc "Learn how CSR Real Estate protects your privacy and handles personal information on our Miami real estate development website." --allow-root

# Set SEO title
docker exec wordpress-local-wordpress-1 wp post meta update <POST_ID> _yoast_wpseo_title "Privacy Policy | CSR Real Estate" --allow-root

Upload Media

From URL:

bash

docker exec wordpress-local-wordpress-1 wp media import "https://images.pexels.com/photos/123456/image.jpg" --title="Privacy Header" --allow-root

Set Featured Image:

bash

docker exec wordpress-local-wordpress-1 wp post meta update <POST_ID> _thumbnail_id <MEDIA_ID> --allow-root

List Pages/Posts

bash

docker exec wordpress-local-wordpress-1 wp post list --post_type=page --allow-root
docker exec wordpress-local-wordpress-1 wp post list --post_type=post --allow-root
docker exec wordpress-local-wordpress-1 wp post list --post_type=property --allow-root

Check/Install Plugins

bash

# List installed plugins
docker exec wordpress-local-wordpress-1 wp plugin list --allow-root

# Install and activate a plugin
docker exec wordpress-local-wordpress-1 wp plugin install wordpress-seo --activate --allow-root

SEO Best Practices

Focus Keyphrase

2-4 words that describe the page content
Should appear in title, meta description, and content
Use naturally, don't keyword stuff

Meta Description

150-155 characters max
Include focus keyphrase
Compelling call to action
Unique for each page

Page Title (SEO Title)

50-60 characters max
Focus keyphrase near the beginning
Brand name at the end (e.g., "Title | CSR Real Estate")

Featured Image

Every page/post should have one
Optimized file size (< 200KB)
Descriptive alt text with keyphrase

Required Theme Modification

Add to theme's functions.php to enable Yoast fields via REST API:

php

// Enable Yoast SEO fields in REST API
function enable_yoast_rest_api() {
    $post_types = ['post', 'page', 'property'];
    foreach ($post_types as $type) {
        register_post_meta($type, '_yoast_wpseo_focuskw', [
            'show_in_rest' => true,
            'single' => true,
            'type' => 'string'
        ]);
        register_post_meta($type, '_yoast_wpseo_metadesc', [
            'show_in_rest' => true,
            'single' => true,
            'type' => 'string'
        ]);
        register_post_meta($type, '_yoast_wpseo_title', [
            'show_in_rest' => true,
            'single' => true,
            'type' => 'string'
        ]);
    }
}
add_action('init', 'enable_yoast_rest_api');

Stock Photo Integration

Pexels API

API Key: Store in /root/.pexels-api-key
Search: curl -H "Authorization: API_KEY" "https://api.pexels.com/v1/search?query=TERM&per_page=5"
Download: Use the src.large or src.original URL from response

Unsplash API

API Key: Store in /root/.unsplash-api-key
Search: curl "https://api.unsplash.com/search/photos?query=TERM&client_id=API_KEY"

Scripts

wp-page.py

Creates a WordPress page with optional SEO and featured image.

Usage:

bash

python3 /root/.claude/skills/wordpress-admin/scripts/wp-page.py \
  --site local \
  --title "Privacy Policy" \
  --slug "privacy-policy" \
  --template "page-privacy-policy.php" \
  --focus-kw "privacy policy" \
  --meta-desc "Description here"

wp-seo.py

Sets Yoast SEO fields for existing posts/pages.

Usage:

bash

python3 /root/.claude/skills/wordpress-admin/scripts/wp-seo.py \
  --site local \
  --post-id 123 \
  --focus-kw "keyword" \
  --meta-desc "Description" \
  --seo-title "SEO Title"

wp-media.py

Downloads stock photo and uploads to WordPress.

Usage:

bash

python3 /root/.claude/skills/wordpress-admin/scripts/wp-media.py \
  --site local \
  --search "miami skyline" \
  --set-featured 123

Docker Management

Start Local WordPress

bash

cd /root/csrdevelopment.com/wordpress-local && docker-compose up -d

Stop Local WordPress

bash

cd /root/csrdevelopment.com/wordpress-local && docker-compose down

View Logs

bash

docker logs wordpress-local-wordpress-1 -f

Reset Database

bash

cd /root/csrdevelopment.com/wordpress-local && docker-compose down -v && docker-compose up -d

FTP Sync (Production)

Sync Theme Files

bash

/root/csrdevelopment.com/sync-to-remote.sh

Upload Single File

bash

lftp -u "alfonso@csrdevelopment.com",'@#s;v1#%1M$+' ftp.csrdevelopment.com << 'EOF'
set ssl:verify-certificate no
cd /public_html/wp-content/themes/csr-theme
put /root/csrdevelopment.com/csrdevelopment.com/public_html/wp-content/themes/csr-theme/FILE.php
bye
EOF

Common Tasks

Create Privacy Policy Page

Create page with slug privacy-policy
Set template to page-privacy-policy.php
Set focus keyphrase: "CSR privacy policy"
Set meta description (~155 chars with keyphrase)
Upload relevant featured image

Create Terms of Service Page

Create page with slug terms
Set template to page-terms.php
Set focus keyphrase: "CSR terms of service"
Set meta description (~155 chars with keyphrase)
Upload relevant featured image

Reference

WordPress REST API: https://developer.wordpress.org/rest-api/
WP-CLI Commands: https://developer.wordpress.org/cli/commands/
Yoast SEO API: https://developer.yoast.com/customization/apis/
Pexels API: https://www.pexels.com/api/documentation/

Search AI Tools

Install this agent skill to your Project

SKILL.md

WordPress Admin Skill

When to Use This Skill

Available Sites

CSR Development (Production)

Local WordPress (Docker)

Workflows

Create a Page

Set Page Template

Configure SEO (Yoast)

Upload Media

List Pages/Posts

Check/Install Plugins

SEO Best Practices

Focus Keyphrase

Meta Description

Page Title (SEO Title)

Featured Image

Required Theme Modification

Stock Photo Integration

Pexels API

Unsplash API

Scripts

wp-page.py

wp-seo.py

wp-media.py

Docker Management

Start Local WordPress

Stop Local WordPress

View Logs

Reset Database

FTP Sync (Production)

Sync Theme Files

Upload Single File

Common Tasks

Create Privacy Policy Page

Create Terms of Service Page

Reference