Agent Native

wp-block-themes

This skill enables agents to develop and debug WordPress block themes by editing theme.json for global settings and styles, managing templates and template…

by AutomatticOfficial publisherNot reviewed

Identity proven by GitHub's verified organisation badge (Automattic)

Agents
Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, OpenCode
License
No license stated
Pin
48d4aa2pinned Oct 9, 2026
Context cost
about 890 tokenswhen the skill loads
GitHub stars
211on automattic/agent-skills
Scripts
1 script

What it does

“Use when developing WordPress block themes: theme.json (global settings/styles), templates and template parts, patterns, style variations, and Site Editor troubleshooting (style hierarchy, overrides, caching).”
The author's description, from SKILL.md

Generated summary from the skill's own text

This skill enables agents to develop and debug WordPress block themes by editing theme.json for global settings and styles, managing templates and template parts, creating patterns and style variations, and troubleshooting Site Editor issues. It provides procedures for theme creation, configuration changes, and verification across WordPress 6.9 and later with reference documentation for common workflows.

When to use it

  • Editing theme.json settings, presets, or per-block styles for block themes
  • Adding or modifying templates, template parts, patterns, or style variations
  • Debugging why styles don't apply or Site Editor doesn't reflect theme changes
  • Converting classic themes to block themes or creating new block themes from scratch

When not to

  • Working with classic PHP-based themes without block support
  • When user customizations in the database should override theme defaults
  • Projects targeting WordPress versions below 6.9

Install

No license stated: install from the publisher's repository, and ask the author before you reuse or share it.

These commands install from the publisher's repository and need no account.

skills CLI

npx skills add automattic/agent-skills --skill wp-block-themes

Installs from the repository's default branch, which may have changed since the commit we checked.

GitHub CLI 2.90 or later

gh skill install automattic/agent-skills wp-block-themes@48d4aa21d0da0e7bda1c7ac155fef2e16b87aa25

Installs the commit we checked (48d4aa2).

Copy by hand

Download the folder at 48d4aa2 and put it in .claude/skills/wp-block-themes for Claude Code and in .agents/skills/wp-block-themes for Codex, Cursor, Gemini CLI, GitHub Copilot and OpenCode.

Skill folder on GitHub at 48d4aa2

Claude Code plugin

/plugin install build-with-wordpress@claude-plugins-official

The publisher's plugin in Claude's official marketplace. It may hold more than this skill, and we have not pinned it.

Copy for your agent

A prompt for any coding agent. It installs this skill from GitHub at the pinned commit, copies the files as they are, and runs nothing unless you ask.

Prompt

Install the agent skill "wp-block-themes" by Automattic.

Source, pinned to commit 48d4aa21d0da0e7bda1c7ac155fef2e16b87aa25:
https://github.com/automattic/agent-skills/tree/48d4aa21d0da0e7bda1c7ac155fef2e16b87aa25/skills/wp-block-themes

1. Download that folder at exactly this commit. Do not use the default branch.
2. Copy every file unchanged, keeping the folder structure, into .claude/skills/wp-block-themes/ for Claude Code and .agents/skills/wp-block-themes/ for Codex, Cursor, Gemini CLI, GitHub Copilot and OpenCode. Create the folders if they do not exist.
3. Do not edit the files, and do not run any script in the folder unless I ask you to.
4. When you are done, list the files you copied and where you put them.

Its license is restricted or not stated. Show me the license terms from the repository before you copy anything.

Listing and checks: https://www.agentnative.dev/skills/automattic/wp-block-themes

SKILL.md at the pin

The license of this skill does not let us show its files here.

View SKILL.md on GitHub at 48d4aa2

Files

8 files, 12 KB in total. Each file has a sha256 in the pin's manifest; the first 12 characters are shown.

Skill folder on GitHub at 48d4aa2
All 31 skills from Automattic

More from Automattic

  • annotate

    This skill opens a browser with annotation tools that let users click page elements and leave feedback, then the agent reads those annotations and applies the…

    Claude Code, Codex, Cursor +3 · about 1K tokens · pinned 6 days ago

  • block-content

    This skill instructs agents to write editable WordPress block markup for block themes, enforcing use of core blocks over HTML, managing layout cascades, and…

    Claude Code, Codex, Cursor +3 · about 4.4K tokens · pinned 6 days ago

  • hosting-plans-helper

    This skill fetches current WordPress.com plan names, pricing, and feature details from live APIs, then answers questions about which plan tier includes…

    Claude Code, Codex, Cursor +3 · about 840 tokens · pinned 6 days ago

  • imagery

    This skill guides generating AI images for WordPress sites using the generate_images tool, or alternative image generation tools.

    Claude Code, Codex, Cursor +3 · about 2.6K tokens · pinned 6 days ago

  • liberate

    This skill helps agents migrate websites into WordPress by copying the site from a URL or local files using the Studio CLI, then comparing the imported…

    Claude Code, Codex, Cursor +4 · about 830 tokens · pinned 6 days ago

  • need-for-speed

    Measures Core Web Vitals and page composition metrics for WordPress sites using synthetic testing, then suggests targeted optimization actions based on…

    Claude Code, Codex, Cursor +3 · about 650 tokens · pinned 6 days ago

All Frontend and design skills

Related in Frontend and design

  • plugin-recommendations

    This skill guides the agent to recommend and install WordPress plugins for features that core blocks don't provide, including WooCommerce for ecommerce…

    by AutomatticOfficial publisher

    Claude Code, Codex, Cursor +3 · about 4.6K tokens · pinned 6 days ago

  • wpcom-remote-management

    This skill enables agents to manage live WordPress.com sites through the wpcom_request tool, handling plan-based feature limitations, content and design…

    by AutomatticOfficial publisher

    Claude Code, Codex, Cursor +3 · about 1.7K tokens · pinned 6 days ago

  • wp-block-development

    This skill guides agents through WordPress block development workflows, including creating new blocks, updating block.json metadata, implementing save/render…

    by AutomatticOfficial publisher

    Contains scripts

    Claude Code, Codex, Cursor +3 · about 1.5K tokens · pinned 6 days ago

  • wp-interactivity-api

    This skill helps build and debug WordPress Interactivity API features, including data-wp-* directives, store management, and block view script modules.

    by AutomatticOfficial publisher

    Claude Code, Codex, Cursor +4 · about 1.4K tokens · pinned 6 days ago

  • wpds

    This skill helps agents build and review UIs using the WordPress Design System, including components, tokens, and patterns.

    by AutomatticOfficial publisher

    Claude Code, Codex, Cursor +4 · about 640 tokens · pinned 6 days ago

  • wordpress-block-theming

    This skill provides guidance for building WordPress block themes using Full Site Editing architecture.

    by AutomatticOfficial publisher

    Claude Code, Codex, Cursor +4 · about 4.7K tokens · pinned 6 days ago

The skills listed here are third-party software, collected from public GitHub repositories as a catalog of recent skills and provided as is. Agent Native does not write or control them and is not responsible for any harm, loss or damage caused by installing or using them. Labels and checks describe what we saw at one commit and are not a guarantee. Read a skill's files before you run it. Terms of use