Agent skill

WordPress Agent Skills: Block Theme and theme.json Rules for AI Agents

WordPress agent skills is a set of skill folders that teach an AI coding agent how to build block themes, blocks and plugins without outdated patterns.

Install
git clone https://github.com/WordPress/agent-skills.git
View on GitHub

Stars, license and last push from GitHub. Install count as reported by the open skills directory.

What are the WordPress agent skills?

WordPress agent skills is the WordPress project's own bundle of portable skill folders for AI coding assistants. Each folder holds a SKILL.md procedure, reference notes and helper scripts. The wp-block-themes skill covers theme.json, templates, template parts, patterns and style variations, so the agent stops guessing at theme structure.

This repository packages WordPress development knowledge as skill folders. The README says AI assistants often produce outdated patterns from before block themes, skip security checks and cause invalid block errors, and each skill is written to prevent that.

Each skill is a self-contained folder. It carries a SKILL.md with when to use it, the procedure and verification, a references folder for deep topics, and optional scripts for detection and validation.

What changes in your agent's output

  • Theme work starts with a triage script that detects the project type, tooling and versions, instead of assuming a layout.
  • Changes to theme.json are split into settings, which control what the editor allows, and styles, which set the default look.
  • Templates live in the templates folder, and template parts sit in the parts folder with no nesting.
  • The agent checks whether user customizations in the Site Editor override theme defaults before it blames the file.
  • Block work follows block.json, attributes, rendering and deprecations, so older markup does not break.

Who it is for

Best for

  • Developers building or converting block themes who want the agent to follow the official theme.json and template rules.
  • Teams that maintain plugins and themes in the same repository and want one router skill to pick the right workflow.
  • Agencies that want a shared, committable skills folder so every developer's agent behaves the same way.

Not for

  • Visual design direction. The skills cover WordPress structure and APIs, not typography or colour taste.
  • Sites on WordPress older than the targeted range. The README states compatibility with WordPress 7.0 and PHP 7.4.0 or newer.
  • Anyone who expects a finished theme from one prompt. These skills guide the agent, they do not generate a site.

Use it with UiChemy

Skills help the agent write WordPress code, while UiChemy handles design to page work. Figma to WordPress converts a design file, and Composer edits the result in Elementor or Gutenberg. Click Get Started on uichemy.com.