์Šคํ‚ฌ wp-block-themes
๐ŸŽจ

wp-block-themes

๋‚ฎ์€ ์œ„ํ—˜ ๐Ÿ“ ํŒŒ์ผ ์‹œ์Šคํ…œ ์•ก์„ธ์Šค

Develop WordPress block themes with expert guidance

WordPress block themes use theme.json for global settings and styles. This skill provides expert guidance for theme.json configuration, template creation, pattern management, and debugging styling issues in the Site Editor.

์ง€์›: Claude Codex Code(CC)
๐Ÿฅ‰ 75 ๋ธŒ๋ก ์ฆˆ
1

์Šคํ‚ฌ ZIP ๋‹ค์šด๋กœ๋“œ

2

Claude์—์„œ ์—…๋กœ๋“œ

์„ค์ • โ†’ ๊ธฐ๋Šฅ โ†’ ์Šคํ‚ฌ โ†’ ์Šคํ‚ฌ ์—…๋กœ๋“œ๋กœ ์ด๋™

3

ํ† ๊ธ€์„ ์ผœ๊ณ  ์‚ฌ์šฉ ์‹œ์ž‘

ํ…Œ์ŠคํŠธํ•ด ๋ณด๊ธฐ

"wp-block-themes" ์‚ฌ์šฉ ์ค‘์ž…๋‹ˆ๋‹ค. Find all block themes in this repository

์˜ˆ์ƒ ๊ฒฐ๊ณผ:

  • Found 2 block themes:
  • โ€ข TwentyTwentyFive (theme.json at theme-twentytwentyfive/theme.json)
  • - Version: 3
  • - Has templates, parts, patterns, and styles folders
  • โ€ข CustomTheme (theme.json at themes/custom-theme/theme.json)
  • - Version: 3
  • - Has templates and parts folders

"wp-block-themes" ์‚ฌ์šฉ ์ค‘์ž…๋‹ˆ๋‹ค. Help me configure theme.json settings

์˜ˆ์ƒ ๊ฒฐ๊ณผ:

  • For WordPress 6.9+, use theme.json version 3.
  • Key settings sections:
  • - color: palette, gradients, duotone
  • - typography: fontFamilies, fontSizes, lineHeight
  • - spacing: spacingScale, spacingUnits
  • - layout: contentSize, wideSize
  • Add presets for editor-visible controls, use styles for default appearance.

"wp-block-themes" ์‚ฌ์šฉ ์ค‘์ž…๋‹ˆ๋‹ค. Why are my styles not applying

์˜ˆ์ƒ ๊ฒฐ๊ณผ:

  • Check the style hierarchy:
  • 1. Core defaults โ†’ 2. theme.json โ†’ 3. child theme โ†’ 4. user customizations
  • Common issues:
  • - Wrong theme edited (check Site Editor โ†’ theme)
  • - User customizations override theme defaults
  • - Invalid JSON syntax in theme.json
  • - Style variations stored in database

๋ณด์•ˆ ๊ฐ์‚ฌ

๋‚ฎ์€ ์œ„ํ—˜
v6 โ€ข 1/16/2026

This skill provides documentation and guidance for WordPress block theme development. The only executable script (detect_block_themes.mjs) safely reads theme.json files using bounded filesystem operations with no network access or command execution. All 92 static findings are false positives: markdown backticks are misinterpreted as shell execution, documentation URLs as network calls, and JSON content hashes as C2 indicators.

9
์Šค์บ”๋œ ํŒŒ์ผ
659
๋ถ„์„๋œ ์ค„ ์ˆ˜
2
๋ฐœ๊ฒฌ ์‚ฌํ•ญ
6
์ด ๊ฐ์‚ฌ ์ˆ˜
์ค‘๊ฐ„ ์œ„ํ—˜ ๋ฌธ์ œ (1)
scripts/detect_block_themes.mjs:30-47
Filesystem Read Operations for Theme Detection
Node.js fs operations for reading theme.json files

์œ„ํ—˜ ์š”์ธ

๐Ÿ“ ํŒŒ์ผ ์‹œ์Šคํ…œ ์•ก์„ธ์Šค (1)
scripts/detect_block_themes.mjs:15-68
๊ฐ์‚ฌ์ž: claude ๊ฐ์‚ฌ ์ด๋ ฅ ๋ณด๊ธฐ โ†’

ํ’ˆ์งˆ ์ ์ˆ˜

68
์•„ํ‚คํ…์ฒ˜
100
์œ ์ง€๋ณด์ˆ˜์„ฑ
85
์ฝ˜ํ…์ธ 
30
์ปค๋ฎค๋‹ˆํ‹ฐ
85
๋ณด์•ˆ
91
์‚ฌ์–‘ ์ค€์ˆ˜

๋งŒ๋“ค ์ˆ˜ ์žˆ๋Š” ๊ฒƒ

Configure theme.json

Set up global settings, presets, typography, colors, and per-block styles in theme.json

Create block templates

Build HTML templates and template parts for block-based WordPress themes

Debug styling issues

Resolve styles not applying, editor mismatch, and style hierarchy problems

์ด ํ”„๋กฌํ”„ํŠธ๋ฅผ ์‚ฌ์šฉํ•ด ๋ณด์„ธ์š”

Detect block themes 
Run detect_block_themes to find all theme.json files in this repository and identify which are block themes
Review theme.json 
Review the theme.json file at [PATH] and suggest improvements for settings and styles
Create new template 
Create a new template file at templates/[NAME].html following WordPress block theme conventions
Debug style issues 
Debug why styles from theme.json are not appearing in the Site Editor. Check style hierarchy and user overrides

๋ชจ๋ฒ” ์‚ฌ๋ก€

  • Run detect_block_themes to verify the correct theme root before making changes
  • Understand style hierarchy: core defaults โ†’ theme.json โ†’ child theme โ†’ user customizations
  • Test changes in the Site Editor and frontend to confirm styles apply correctly

ํ”ผํ•˜๊ธฐ

  • Editing theme.json without understanding the style hierarchy
  • Creating templates without checking existing patterns and conventions
  • Activating a new theme without verifying theme.json configuration

์ž์ฃผ ๋ฌป๋Š” ์งˆ๋ฌธ

What WordPress versions are supported?
Targets WordPress 6.9+ with theme.json schema version 3. Earlier versions use different schema versions.
What are theme.json versions?
theme.json has schema versions. Version 3 requires WordPress 6.9+. Use version 2 for 6.4-6.8.
How does this skill integrate with other tools?
Works with wp-project-triage for project detection. WP-CLI may be needed for some workflows.
Does this skill modify my files?
No. This skill provides guidance and references. It does not write to files or execute unsafe operations.
Why are my theme.json styles not applying?
Check: correct theme edited, valid JSON syntax, user customizations not overriding, correct style hierarchy.
How are style variations different from theme.json?
Style variations (styles/*.json) are user-selectable presets. Once selected, the choice is stored in the database.

๊ฐœ๋ฐœ์ž ์„ธ๋ถ€ ์ •๋ณด

์ž‘์„ฑ์ž

Automattic

๋ผ์ด์„ ์Šค

GPL-2.0-or-later

๋ฆฌํฌ์ง€ํ† ๋ฆฌ

https://github.com/Automattic/agent-skills/tree/trunk/skills/wp-block-themes

์ฐธ์กฐ

trunk

ํŒŒ์ผ ๊ตฌ์กฐ

๐Ÿ“ references/

๐Ÿ“„ creating-new-block-theme.md

๐Ÿ“„ debugging.md

๐Ÿ“„ patterns.md

๐Ÿ“„ style-variations.md

๐Ÿ“„ templates-and-parts.md

๐Ÿ“„ theme-json.md

๐Ÿ“ scripts/

๐Ÿ“„ detect_block_themes.mjs

๐Ÿ“„ SKILL.md