wp-theme

Bootstrap a WordPress block theme project with theme.json, templates, and patterns.

14|1|Updated Mar 30, 2026
One-click install
npx skills add https://github.com/wpgaurav/WordPress-skills --skill wp-theme
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: wp-theme
Source: https://github.com/wpgaurav/WordPress-skills/tree/main/skills/wordpress/wp-theme
Command: npx skills add https://github.com/wpgaurav/WordPress-skills --skill wp-theme

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

WordPress theme developers often spend time scaffolding boilerplate files and configurations. This Skill provides a ready-to-use blueprint for building modern block themes with theme.json, templates, and patterns, enabling faster, more consistent theme development.

Core Features & Use Cases

  • Theme skeleton with theme.json, style.css, functions.php, and pattern scaffolding for Full Site Editing.
  • Block templates and patterns ready for FSE workflows, including parts, templates, and pattern registration.
  • Clear file organization guidance for scalable themes, including templates, template-parts, and assets, to accelerate team collaboration.

Quick Start

Create a new theme directory, add a proper style.css header and a theme.json, then start building templates, parts, and patterns as shown in wp-theme.

Frequently Asked Questions about wp-theme

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I scaffold a WordPress block theme with theme.json and patterns?

To scaffold a WordPress block theme, generate a complete skeleton including theme.json, style.css, functions.php, and pattern directories. This provides a standards-compliant file layout for Full Site Editing workflows, supporting block templates, template parts, and PHP integration points.

What files do I need for a Full Site Editing block theme?

A Full Site Editing block theme requires theme.json for global styles, style.css with a proper header, functions.php for pattern registration, and dedicated directories for templates and template parts. Pattern scaffolding is also needed to register reusable block configurations.

Can I use this block theme scaffold for production-ready Gutenberg workflows?

Yes, this block theme scaffold meets requirements for a reusable, production-ready theme by providing coding conventions, a recommended file layout, and integration points for Gutenberg blocks, ensuring scalable and standards-compliant development across Full Site Editing scenarios.

What is the best way to organize templates and patterns in a WordPress block theme?

The best way to organize templates and patterns is by following a clear file structure that separates templates, template-parts, and assets. This organization accelerates team collaboration and provides integration points for registering patterns within the Gutenberg editor.

Does scaffolding a block theme require PHP configuration for pattern registration?

Yes, scaffolding a block theme requires PHP configuration in functions.php to register patterns and define integration points for Gutenberg blocks. This PHP scaffolding supports Full Site Editing by enabling reusable block patterns and template parts.

Why do I need theme.json when building a WordPress block theme?

You need theme.json when building a WordPress block theme because it defines global style configurations and settings for the Gutenberg editor. It serves as the central configuration file for Full Site Editing, controlling typography, colors, and layout definitions across templates and patterns.