wp-i18n-audit

Audit WordPress PHP code for internationalization correctness and text-domain consistency.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/vikingokft/wp-agent-skills --skill wp-i18n-audit-vikingokft
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: wp-i18n-audit
Source: https://github.com/vikingokft/wp-agent-skills/tree/main/wordpress/wp-i18n-audit
Command: npx skills add https://github.com/vikingokft/wp-agent-skills --skill wp-i18n-audit-vikingokft

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

WordPress plugins and themes often ship with translation mistakes that cause missing strings, broken .pot extraction, or text that fails to translate at runtime.

Core Features & Use Cases

  • i18n correctness audit: Checks translation function usage, including text-domain consistency, escaped output helpers, and correct helper selection.
  • Release and contributor readiness: Reviews PHP code during releases, contributor PRs, and migrations to a new text domain.
  • Translator issue triage: Helps diagnose why translators report missing or broken strings in the .pot and runtime.

Quick Start

Ask the AI to run a WordPress i18n audit on the plugin/theme PHP files and produce a severity-sorted report with file locations, offending code, and specific fixes.

Frequently Asked Questions about wp-i18n-audit

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I audit WordPress plugin PHP code for i18n translation bugs?

To audit WordPress plugin PHP code for i18n bugs, scan files to check text-domain consistency, validate placeholder and pluralization patterns, and verify escaped translation helpers. This prevents broken translation extraction and runtime failures.

Why are translation strings missing from my WordPress plugin .pot file?

Translation strings go missing from a WordPress plugin .pot file when dynamic translation strings or variable text domains are used. Auditing code to ban variable domains and validate translation function usage resolves these extraction failures.

How do I check WordPress text-domain consistency for a theme migration?

To check WordPress text-domain consistency during a theme migration, audit the PHP code to ensure all translation functions use the correct domain. This validates that text-domain loading hooks are properly configured and prevents runtime translation failures.

What is the best way to review WordPress internationalization correctness in contributor PRs?

The best way to review WordPress internationalization correctness in contributor PRs is running an i18n audit that checks escaped output helpers, correct translation function selection, and pluralization patterns to produce a severity-sorted report.

Does this i18n audit check WordPress escaped translation helpers and pluralization patterns?

Yes, the i18n audit checks WordPress escaped translation helpers and validates pluralization patterns. It ensures correct helper selection and verifies that placeholder formats match across singular and plural translation strings.

Can I use this audit to diagnose translator-reported text-domain mismatches at runtime?

Yes, you can use this audit to diagnose translator-reported text-domain mismatches at runtime. It checks text-domain consistency, validates loading hooks, and identifies dynamic strings that break translation extraction and runtime display.