wp-agent-skills
AI agent skills for managing a WordPress personal site — install, theme setup, page building, media, SEO, security, and health checks. Built for Full Site Editing (FSE) + GSAP animations.
Component Overview
Install
npx claudepluginhub antonysilverhand/wp-agent-skills --plugin wp-agent-skillsComponent Details
Skills (10)
Upload, optimize, and register images or video to the WordPress media library. Use when adding photos to the site, uploading a new profile picture, resolving IMAGE: placeholders left after wp-new-page, or when the user says "add this photo", "upload my picture", or "use this image on the site". Also handles bulk placeholder resolution after a page is created.
Create or update a named WordPress block pattern — a reusable, animated, responsive page section that becomes part of the site's design vocabulary. Use when building a new section type (hero, gallery, timeline, contact, etc.), updating an existing pattern, or when the user describes a visual section they want on their site. Produces production-grade markup using the site's design tokens and GSAP data-anim attributes.
Update the site's global design tokens — colors, typography, spacing — in theme.json. Use when the user wants to change the site's color scheme, switch fonts, adjust sizing, or restyle the entire site. A single run propagates the change everywhere. Examples of triggers: "make it darker", "change the accent to rose", "use a bigger body font", "switch to a serif headline font".
Run a health check on the WordPress site — performance, broken links, security basics, plugin updates, and accessibility. Use before a site launch, after major changes, when something seems broken, or when the user asks to "check the site", "audit the site", or "make sure everything is working". Reports issues with severity levels and recommended fixes.
Set up WordPress for a personal site — either connect to an existing installation or install a fresh one. Use at the very start of any site project, when the user says "I don't have WordPress yet", "install WordPress for me", "set up the site", or "where do I start". Detects the OS (Windows, macOS, Linux) and environment, chooses the best install method, configures credentials, and sets the WP_SITE_URL/WP_USER/WP_APP_PASSWORD environment variables so all other wp-* skills can run.
Create a new WordPress page by assembling existing block patterns, filling in real content, and publishing or saving as draft. Use when the user wants to add a new page to the site — home, about, portfolio, contact, projects, or any custom page. Takes a title and content brief; outputs a complete, ready-to-review page. Does not create generic Lorem Ipsum — all content is specific to the brief.
Install and configure Wordfence security on a WordPress site — firewall, malware scanner, login protection, and hardening settings. Use when setting up a new site, when the user asks to "secure the site", "add security", "install Wordfence", or before going live. Also use when a security issue is suspected. Applies a layered security baseline: Wordfence + core hardening + file permission checks.
Run an SEO optimization pass on one page or the entire site — meta titles, descriptions, Open Graph tags, structured data, and image alt text. Use when the site is ready to launch, when the user asks to "improve SEO", "make the site searchable", "add meta descriptions", or after adding new pages. Also use when missing alt text is reported.
Scaffold a WordPress Full Site Editing (FSE) theme for a personal website — including GSAP scroll animations, fluid design tokens, and a block pattern registry. Use when setting up a new WordPress site from scratch, rebuilding the theme, or when the user asks to initialise or scaffold the site theme. Activates via WP-CLI and WP REST API.
Edit a specific section, block pattern, or piece of content on the site. Use when the user wants to change copy, swap a photo, add or remove a timeline item, update a quote, fix a heading, or change anything on a specific page or across a reusable pattern. Makes surgical edits — does not rebuild the whole page. Examples: "change the hero headline", "update the about section", "add a new project to the gallery", "fix the contact email".
README
Happy Birthday, Lavon 🎂 — with love from BP Debate Union. One of our finest past presidents. This repo is your gift.
wp-agent-skills
AI agent skills for managing a WordPress personal site — from zero to live with a single command.
Built for Full Site Editing (FSE) + GSAP animations, cross-OS (Windows/macOS/Linux).
Install
npx skills add https://github.com/AntonySilverhand/wp-agent-skills
Or in Claude Code:
/plugin marketplace add AntonySilverhand/wp-agent-skills
Works with Claude Code, Cursor, Windsurf, Codex, Gemini CLI, OpenCode, and 40+ agents.
Skills
| Skill | Purpose |
|---|---|
wp-install | Detect OS, install WordPress (local SQLite or remote), configure credentials |
wp-setup-theme | Scaffold a custom FSE theme with GSAP animations.js and theme.json tokens |
wp-create-pattern | Create or update a named block pattern |
wp-define-style | Set global colors, fonts, spacing in theme.json |
wp-new-page | Assemble a new page from existing block patterns |
wp-update-section | Surgically edit a pattern across all pages |
wp-add-media | Upload, WebP-optimize, and register media |
wp-seo-pass | Full SEO pass — meta, Open Graph, schema, alt text |
wp-health-check | Parallel check: updates, performance, links, security, a11y |
wp-security | Wordfence setup, author enumeration block, REST API hardening, file protection |
Design workflow
These skills compose with the Anthropic frontend-design skill and GreenSock GSAP skills. Install them alongside:
npx skills add https://github.com/anthropics/skills
npx skills add https://github.com/greensock/gsap-skills
Then follow this sequence:
/theme-factory → pick a palette + font pair
/frontend-design → commit to a bold aesthetic direction
/wp-define-style → encode into theme.json
/wp-setup-theme → scaffold FSE theme with GSAP
/wp-new-page → assemble pages from patterns
/wp-security → harden before going live
/wp-health-check → final QA pass
Animation system
The theme's animations.js reads data-anim attributes — no GSAP code needed in patterns:
| Attribute | Effect |
|---|---|
data-anim="fade-up" | Fade in from below on scroll |
data-anim="reveal-left" | Slide in from left |
data-anim="parallax" | Parallax scroll depth |
data-anim="text-split" | Character-by-character reveal |
data-anim="counter" | Animated number counter |
Requirements
- PHP 8.0+
- WP-CLI (auto-downloaded by
wp-install) - Local: PHP built-in server + SQLite (no MySQL needed)
- Remote: SSH or cPanel access
License
MIT
Similar Plugins
fullstack-dev-skills
Comprehensive skill pack with 66 specialized skills for full-stack developers: 12 language experts (Python, TypeScript, Go, Rust, C++, Swift, Kotlin, C#, PHP, Java, SQL, JavaScript), 10 backend frameworks, 6 frontend/mobile, plus infrastructure, DevOps, security, and testing. Features progressive disclosure architecture for 50% faster loading.