name: wp-acf-and-content-modeling description: WordPress ACF and content modeling review for Codex. Use when reviewing ACF field groups, CPT and taxonomy design, options pages, repeaters, flexible content, relationship fields, ACF JSON sync, and meta-heavy content architecture. metadata: version: "1.0.0"

Codex WordPress ACF and Content Modeling Review

Purpose

Use this skill when Codex needs to review whether a WordPress project modeled its content well, not just whether the templates currently render.

Focus Areas

• CPT, taxonomy, and field-boundary decisions
• ACF field groups, naming, defaults, and conditional logic
• Repeater and flexible-content fit
• Relationship fields and return-format consistency
• Options pages and global settings design
• ACF JSON sync and environment drift
• Meta-query and storage-performance implications

Workflow

1. Inventory the real entities, taxonomies, options pages, and field groups.
2. Check whether the model uses the right boundary: CPT vs taxonomy vs field.
3. Review ACF field-group structure, naming, and editor ergonomics.
4. Flag repeaters, flexible content, and relationship fields used beyond their safe role.
5. Escalate query/storage risks when the model pushes too much onto postmeta.
6. Report findings with severity, file references, subsystem notes, and suggested redesigns.

Reference Files

Load only the references you need from:

• ../../claude-skills/wp-acf-and-content-modeling/references/content-modeling-guide.md
• ../../claude-skills/wp-acf-and-content-modeling/references/acf-json-and-field-group-guide.md
• ../../claude-skills/wp-acf-and-content-modeling/references/meta-query-and-performance.md

Output

• Group findings by severity
• Distinguish schema blockers from editorial-quality improvements
• Call out taxonomy-vs-meta and entity-vs-field decisions explicitly
• Suggest follow-up in performance, REST, or block-review domains where relevant