SKILL.md
$27
- ❌ camelCase naming - Must use snake_case for methods/variables/hooks (code-entities.md)
- ❌ Yoda condition violations - Must follow WordPress Coding Standards (coding-conventions.md)
Documentation:
- ❌ **Missing
@sinceannotations** - Required for public/protected methods and hooks (code-entities.md)
- ❌ Missing docblocks - Required for all hooks and methods (code-entities.md)
- ❌ Verbose docblocks - Keep concise, one line is ideal (code-entities.md)
Data Integrity:
- ❌ Missing validation - Must verify state before deletion/modification (data-integrity.md)
Testing:
- ❌ **Using
$instancein tests** - Must use$sutvariable name (unit-tests.md)
- ❌ **Missing
@testdox** - Required in test method docblocks (unit-tests.md)
- ❌ Test file naming - Must follow convention for
includes/vssrc/(unit-tests.md)
Frontend JS/TS Code
Architecture & Structure:
- ❌ Barrel self-import (circular dependency) — a JS/TS file anywhere in the monorepo importing from its own package barrel (
from '../',from '../../',from '../index',from '../../index') when that barrel re-exports it. Relevant to SWC TDZ / esbuild tree-shaking / tsc incremental builds. Fix: use the direct module path instead.
UI Text & Copy
Consult the woocommerce-copy-guidelines skill. Flag:
- ❌ Title Case in UI - Must use sentence case (sentence-case.md)
- Wrong: "Save Changes", "Order Details", "Payment Options"
- Correct: "Save changes", "Order details", "Payment options"
- Exceptions: Proper nouns (WooPayments), acronyms (API), brand names
Review Approach
- Scan for critical violations listed above
- Cite specific skill files when flagging issues
- Provide correct examples from the skill documentation
- Group related issues for clarity
- Be constructive - explain why the standard exists when relevant
Output Format
For each violation found:
❌ [Issue Type]: [Specific problem]
Location: [File path and line number]
Standard: [Link to relevant skill file]
Fix: [Brief explanation or example]Notes
- All detailed standards are in the
woocommerce-backend-dev,woocommerce-dev-cycle, andwoocommerce-copy-guidelinesskills
- Consult those skills for complete context and examples
- When in doubt, refer to the specific skill documentation linked above