Open
Conversation
Introduces a new SKILL.md file detailing the purpose, guidelines, and procedures for creating WordPress block patterns. The document emphasizes technical correctness, design distinctiveness, accessibility, and theme compatibility, providing a comprehensive framework for developers to follow when designing patterns. This addition aims to enhance the quality and consistency of block patterns within the WordPress ecosystem.
Introduces a new markdown file detailing common mistakes in design and development of WordPress block patterns. The document covers generic aesthetic markers, technical anti-patterns, and accessibility failures, providing guidelines for improvement. This addition aims to enhance the quality and usability of block patterns within the WordPress ecosystem.
Introduces a new markdown file that serves as a comprehensive reference for WordPress block markup. The document outlines comment syntax, most-used blocks in patterns, style attribute structure, preset class naming conventions, block locking, and alignment options. This addition aims to provide developers with clear guidelines and examples for effectively utilizing block patterns in WordPress.
Introduces a new markdown file that provides comprehensive guidelines on translating design intent into WordPress block attributes using theme.json presets. The document covers core principles, preset mapping for colors, font sizes, font families, spacing scales, and techniques for spatial rhythm, typography pairing, and visual weight. This addition aims to enhance the design consistency and usability of block patterns within the WordPress ecosystem.
Introduces a new markdown file that outlines the default pattern categories and types in WordPress. The document includes guidance on category selection, starter patterns, template patterns, and block type connections. This addition aims to provide developers with a comprehensive reference for effectively utilizing and categorizing block patterns within the WordPress ecosystem.
Introduces a new markdown file that outlines the process for registering block patterns in WordPress. The document covers auto-registration via the `/patterns/` directory, required file headers, PHP execution guidelines, manual registration methods, and best practices for pattern categorization. This addition aims to provide developers with a comprehensive reference for effectively creating and managing block patterns within the WordPress ecosystem.
|
The following accounts have interacted with this PR and/or linked issues. I will continue to update these lists as activity occurs. You can also manually ask me to refresh this list by adding the If you're merging code through a pull request on GitHub, copy and paste the following into the bottom of the merge commit message. To understand the WordPress project's expectations around crediting contributors, please review the Contributor Attribution page in the Core Handbook. |
Revised the compatibility section to specify that WordPress 6.9 and PHP 7.2.24 or later are required, while maintaining previous requirements for auto-registration and full preset support. This update ensures developers have accurate information regarding system requirements for utilizing block patterns effectively.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
This pull request introduces the
wp-patternsskill, aimed at generating high-quality, technically correct, and distinctive WordPress block patterns. This is a complementary skill for creating granular elements in the Block Theme. Helping users that wants to update their existing themes or create reusable Patterns across different projects.The additions include a main skill guide, detailed anti-patterns to avoid, and an extensive reference for block markup syntax and best practices. These resources collectively establish strong guardrails for pattern generation, ensuring technical compliance, design uniqueness, and accessibility.
Key additions and improvements:
1. Skill Documentation and Guardrails
SKILL.mdforwp-patterns, detailing the purpose, constraints, design process, technical validation, and example prompts for generating WordPress block patterns. This guide emphasizes technical correctness, design distinction, theme compatibility, and accessibility, providing a step-by-step procedure and quality checklist for pattern creation.2. Anti-Patterns Reference
references/anti-patterns.md, outlining common mistakes that lead to generic, broken, or inaccessible patterns. The document covers layout, color, typography pitfalls, technical errors (like missing escaping/i18n, hardcoded colors, unclosed blocks), and accessibility failures, with clear code examples and corrections.3. Block Markup Reference
references/block-markup-reference.md, an in-depth guide to WordPress block comment syntax, commonly used blocks, style attributes, preset conventions, block locking, and alignment. This reference includes practical code snippets and explanations to ensure valid, maintainable, and theme-compatible block markup.