Agent skill

WooCommerce PHP Performance Patterns

by woocommerce in woocommerce/woocommerce

Flags and fixes performance issues in WooCommerce PHP code: missing post cache priming, uncached option lookups in loops, and inefficient SQL query patterns.

Custom licenceAuto-check passedDatabases

Install WooCommerce PHP Performance Patterns

skills CLI
$ npx skills add woocommerce/woocommerce --skill woocommerce-performance -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install woocommerce/woocommerce woocommerce-performance --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/woocommerce/woocommerce.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.ai/skills/woocommerce-performance .claude/skills/woocommerce-performance && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
woocommerce-performance
GitHub stars
11k
Token cost
~395 tokens
SKILL.md length
140 words
Files
4
Skills in repo
11
Repo updated
First seen
Licence
Custom licence

At a glance

Flags and fixes performance issues in WooCommerce PHP code: missing post cache priming, uncached option lookups in loops, and inefficient SQL query patterns.

  • Reviewing code that loads a list of WooCommerce products or orders
  • SKILL.md covers Post Cache Priming —…, Options Cache Priming —… and SQL Query Patterns —…
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • Writing a loop that reads several WordPress options

What it does

This skill points the agent to three focused reference files for reviewing or writing performance-sensitive WooCommerce PHP code. The post cache priming guide covers `_prime_post_caches()` for code that loads collections of post-based objects, such as products or orders, or renders product lists with images, both as a pattern to apply when writing new code and as a check when reviewing existing code.

The options cache priming guide covers `wp_prime_option_caches()` for code that reads several non-autoloaded options in a loop or method, across static key lists, derivable key patterns and dynamically extracted key sets, while noting that already-autoloaded options need no priming. The SQL query patterns guide addresses redundant posts joins, a fan-out join on `wp_term_relationships`, N-query loops, OR conditions that break index merges, cross-product meta conditions, decoupling multi-fan joins, preferring WooCommerce's own lookup tables such as `wc_product_meta_lookup`, and eliminating full scans behind MIN and MAX aggregates.

When your agent uses it

  • Reviewing code that loads a list of WooCommerce products or orders
  • Writing a loop that reads several WordPress options
  • Writing or reviewing a SQL query that joins against term relationships or product meta
  • Investigating a slow WooCommerce admin or storefront query

Example prompts

  • “Review this function that loads 50 orders for missing cache priming.”
  • “This loop reads ten options per product. Does it need wp_prime_option_caches?”
  • “Rewrite this query to use wc_product_meta_lookup instead of joining postmeta directly.”

Requirements

  • A WooCommerce or WordPress PHP codebase

What it can do on your machine

Read from SKILL.md and the folder at commit b41b964. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

WooCommerce PHP Performance Patterns loads about 395 tokens when it runs. Until then it costs about 85 tokens; SKILL.md has 140 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~85
When it runs · the whole SKILL.md, loaded when a task matches
~395

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 140 words (~395 tokens).

“Use when writing or reviewing code that loads collections of post-based objects (products, orders) or renders product lists with images. Covers _prime_post_caches() usage patterns — both as a generation guide (apply these patterns when writing new code) and a review…”

— opening of SKILL.md by woocommerce, Custom licence
name
woocommerce-performance

Read the full SKILL.md on GitHub

Files

SKILL.md and 3 other files in .ai/skills/woocommerce-performance of woocommerce/woocommerce.

  • SKILL.md
  • cache-priming.md
  • options-cache-priming.md
  • sql-query-patterns.md

Open the folder on GitHubat commit b41b964

Compare with similar skills

WooCommerce PHP Performance Patterns next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

WooCommerce PHP Performance Patterns compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
WooCommerce PHP Performance Patterns this skillwoocommerce/woocommerce11k—~395Automated safety check: PassCustom licence
SQL Optimizationgithub/awesome-copilot40k2 repos~2.3kAutomated safety check: PassMIT
SQL Optimizationtotvs/engpro-advpl-tlpp-skills143—~1.2kAutomated safety check: PassMIT
WordPress ProJeffallan/claude-skills12k—~1.6kAutomated safety check: PassMIT
Wordpresssickn33/agentic-awesome-skills47k2 repos~348Automated safety check: PassMIT
Relational Query ProcessorFoundationDB/fdb-record-layer675—~1kAutomated safety check: PassApache-2.0

Similar skills

  • SQL Optimization

    github/awesome-copilot

    Official

    Universal SQL performance optimization assistant for comprehensive query tuning, indexing strategies, and database performance analysis across all SQL databases (MySQL, PostgreSQL, SQL Server…

    40k GitHub starsUsed in 2 repos~2.3k tokens
    DatabasesAuto-check passed
  • SQL Optimization

    totvs/engpro-advpl-tlpp-skills

    Universal SQL performance optimization assistant for comprehensive query tuning, indexing strategies, and database performance analysis across SQL databases (PostgreSQL, SQL Server, Oracle).

    143 GitHub stars~1.2k tokensUpdated 3 days ago
    DatabasesAuto-check passed
  • WordPress Pro

    Jeffallan/claude-skills

    Develops WordPress themes, plugins, Gutenberg blocks and WooCommerce features with nonce, escaping and capability checks, phpcs linting and caching tuned for speed.

    12k GitHub stars~1.6k tokensUpdated 5 days ago
    DevelopmentAuto-check passed
  • Wordpress

    sickn33/agentic-awesome-skills

    Complete WordPress development workflow covering theme development, plugin creation, WooCommerce integration, performance optimization, and security hardening.

    47k GitHub starsUsed in 2 repos~348 tokens
    SecurityAuto-check passed
  • Relational Query Processor

    FoundationDB/fdb-record-layer

    Specialized skill for working in the fdb-relational-core SQL processing layer — parser, plan generator, and Cascades planner.

    675 GitHub stars~1k tokensUpdated yesterday
    DatabasesAuto-check passed
  • Performance optimization patterns for the HMIS project. An agent skill from hmislk/hmis.

    236 GitHub stars~499 tokensUpdated today
    DatabasesAuto-check passed

More from woocommerce/woocommerce

All 11 skills in this repo
  • WooCommerce Code Review

    woocommerce/woocommerce

    Reviews WooCommerce code changes against the project's standards, flagging backend PHP architecture, naming, documentation, data integrity and testing violations.

    11k GitHub starsUsed in 3 repos~1.1k tokens
    Auto-check passed
  • WooCommerce Markdown Guidelines

    woocommerce/woocommerce

    Rules for writing and editing markdown in the WooCommerce repository, with the project's markdownlint settings for headings, lists and code blocks.

    11k GitHub starsUsed in 1 repo~1.7k tokens
    Auto-check passed
  • Sets up a local environment for the WooCommerce block email editor, with a watcher, Mailpit email capture and build and test commands for its PHP and JS packages.

    11k GitHub stars~893 tokensUpdated today
    Auto-check passed
  • WooCommerce Dev Cycle

    woocommerce/woocommerce

    Workflow for WooCommerce development: run PHP and JavaScript tests, lint and fix code style on the current branch, and follow guides for i18n and markdown.

    11k GitHub starsUsed in 3 repos~431 tokens
    Auto-check passed
  • WooCommerce Git Commit

    woocommerce/woocommerce

    Commits pending changes with short, verb-first messages that follow WooCommerce repository conventions, splitting commits only when changes are clearly unrelated.

    11k GitHub stars~1.2k tokensUpdated today
    Auto-check passed
  • WooCommerce Draft PR Creator

    woocommerce/woocommerce

    Opens a concise draft pull request for the current branch, working out change type, base branch, title and body from the commits and diff.

    11k GitHub stars~1.1k tokensUpdated today
    Auto-check passed

Works with

Questions about WooCommerce PHP Performance Patterns

What does WooCommerce PHP Performance Patterns do?

Flags and fixes performance issues in WooCommerce PHP code: missing post cache priming, uncached option lookups in loops, and inefficient SQL query patterns. This skill points the agent to three focused reference files for reviewing or writing performance-sensitive WooCommerce PHP code. The post cache priming guide covers `_prime_post_caches()` for code that loads collections of post-based objects, such as products or orders, or renders product lists with images, both as a pattern to apply when writing new code and as a check when reviewing existing code.

When should I use WooCommerce PHP Performance Patterns?

WooCommerce PHP Performance Patterns fits situations like: reviewing code that loads a list of WooCommerce products or orders; writing a loop that reads several WordPress options; writing or reviewing a SQL query that joins against term relationships or product meta; investigating a slow WooCommerce admin or storefront query.

How do I install WooCommerce PHP Performance Patterns in Claude Code?

Run `npx skills add woocommerce/woocommerce --skill woocommerce-performance -a claude-code`. Or copy the skill folder (.ai/skills/woocommerce-performance in woocommerce/woocommerce) into .claude/skills/woocommerce-performance in your project. Claude Code loads it when a task matches its description.

How do I install WooCommerce PHP Performance Patterns in Codex?

Run `npx skills add woocommerce/woocommerce --skill woocommerce-performance -a codex`. Or copy the skill folder (.ai/skills/woocommerce-performance in woocommerce/woocommerce) into .agents/skills/woocommerce-performance in your project. Codex loads it when a task matches its description.

Can I use WooCommerce PHP Performance Patterns in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add woocommerce/woocommerce --skill woocommerce-performance -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/woocommerce-performance, .gemini/skills/woocommerce-performance, .github/skills/woocommerce-performance and .opencode/skills/woocommerce-performance in your project.

What does WooCommerce PHP Performance Patterns need to run?

SKILL.md names no scripts, command-line tools or credentials: WooCommerce PHP Performance Patterns is instructions for the agent only. Our summary lists: A WooCommerce or WordPress PHP codebase.

Does WooCommerce PHP Performance Patterns access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is WooCommerce PHP Performance Patterns safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does WooCommerce PHP Performance Patterns use?

WooCommerce PHP Performance Patterns has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.

How many tokens does WooCommerce PHP Performance Patterns use?

About 395 tokens (SKILL.md is roughly 1.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to WooCommerce PHP Performance Patterns?

Skills that share tags, products or a category with WooCommerce PHP Performance Patterns: SQL Optimization (github/awesome-copilot, 40k stars), SQL Optimization (totvs/engpro-advpl-tlpp-skills, 143 stars), WordPress Pro (Jeffallan/claude-skills, 12k stars) and Wordpress (sickn33/agentic-awesome-skills, 47k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains WooCommerce PHP Performance Patterns?

woocommerce (a GitHub organization) maintains it in woocommerce/woocommerce, which has 10,540 GitHub stars. The repository holds 11 skills in this directory. The repository was last updated on October 8, 2026.

Source: woocommerce/woocommerce on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.