imlazy-wordpress

WordPress + ACF Development Skill

Comprehensive guidance for WordPress theme/plugin development and ACF field management.

This skill incorporates patterns from the official WordPress Agent Skills — see their skills/ directory for deeper dives on specific topics.

Cross-reference: use Skill(imlazy-php-review) for PHP-level code review of any WordPress code encountered.

When to Activate

• Building or modifying WordPress themes (classic or block)
• Creating or reviewing WordPress plugins
• Working with ACF field groups, blocks, or options pages
• Implementing custom REST API endpoints
• Enqueuing scripts/styles or registering blocks
• Performing WordPress security review
• Writing WP_Query loops or custom database queries

WordPress Core

1. Theme Development

Template Hierarchy

WordPress resolves page templates in a strict order. Understand the file that will load:

single-{post-type}-{slug}.php  →  single-{post-type}.php  →  single.php  →  singular.php  →  index.php
page-{slug}.php               →  page-{id}.php            →  page.php    →  singular.php  →  index.php
category-{slug}.php           →  category-{id}.php        →  category.php →  archive.php   →  index.php
tag-{slug}.php                →  tag-{id}.php             →  tag.php     →  archive.php   →  index.php
taxonomy-{tax}-{term}.php     →  taxonomy-{tax}.php       →  taxonomy.php →  archive.php   →  index.php
archive-{post-type}.php       →  archive.php              →  index.php

Use is_*() conditionals in index.php as a fallback, not as a replacement for the hierarchy.

Block Themes (FSE)

// theme.json — the heart of a block theme
{
  "version": 2,
  "settings": {
    "color": {
      "palette": [
        { "slug": "primary", "color": "#1d2327", "name": "Primary" },
        { "slug": "accent",  "color": "#007cba", "name": "Accent" }
      ]
    },
    "typography": {
      "fontSizes": [
        { "slug": "small", "size": "13px", "name": "Small" },
        { "slug": "medium", "size": "20px", "name": "Medium" }
      ]
    }
  },
  "templates": {
    "index": { "title": "Index", "postTypes": [ "page", "post" ] }
  }
}