mirror of
https://github.com/WordPress/agent-skills.git
synced 2026-09-14 15:56:59 +08:00
Fellyph Cintra
c212346296
This pull request introduces the `wp-patterns` skill, 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** - Added `SKILL.md` for `wp-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** - Introduced `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** - Added `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.