From claude-wp-builder
Audit criteria, severity definitions, report JSON schema, and quality thresholds for wp-audit agents
How this skill is triggered — by the user, by Claude, or both
Slash command
/claude-wp-builder:wp-audit-standardsThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
This skill defines the audit criteria, severity levels, report format, and quality thresholds used by all wp-audit agents.
This skill defines the audit criteria, severity levels, report format, and quality thresholds used by all wp-audit agents.
| Severity | Meaning | Action |
|---|---|---|
| CRITICAL | Security vulnerability, complete accessibility failure, broken core functionality | Fix immediately |
| WARNING | Best-practice violation, degraded UX, performance issue | Fix before delivery |
| INFO | Optimization opportunity, minor improvement | Fix when convenient |
All audit agents MUST output findings in this format:
{
"category": "security|seo|a11y|performance|best-practices",
"tier": 1,
"issues": [
{
"severity": "critical|warning|info",
"code": "SEC-001",
"message": "Human-readable description",
"file": "path/to/file.php",
"line": 42,
"auto_fixable": true,
"fix_method": "Description of how to fix"
}
],
"summary": {
"total": 0,
"critical": 0,
"warning": 0,
"info": 0,
"auto_fixable": 0
}
}
category — one of: security, seo, a11y, performance, best-practicestier — integer 1–3 indicating which audit tier produced the findingissues — array of issue objects (may be empty)severity — one of: critical, warning, infocode — prefixed issue code (see Issue Code Prefixes below)message — human-readable description of the problemfile — relative path to the affected fileline — line number (0 if not applicable)auto_fixable — boolean indicating whether the agent can safely fix thisfix_method — description of the fix approachsummary — counts aggregated from the issues array| Prefix | Domain |
|---|---|
SEC-xxx | Security |
SEO-xxx | SEO |
A11Y-xxx | Accessibility |
PERF-xxx | Performance |
WP-xxx | Best Practices |
File scanning via Read, Grep, Glob. No runtime environment required.
.wp-create.json exists)Plugin management, option reading, database queries. Requires a working WordPress installation with WP-CLI access.
Lighthouse-style browser audits. Requires the web-quality-skills package for browser-based testing.
| Resource | Budget |
|---|---|
| CSS compressed | <100KB |
| JS compressed | <300KB |
| Total page weight | <1.5MB |
| Images above-fold | <500KB |
| Fonts total | <100KB |
| Requirement | Minimum |
|---|---|
| Normal text contrast | 4.5:1 |
| Large text contrast (>=18px or >=14px bold) | 3:1 |
| UI component contrast | 3:1 |
| Touch target size | 44x44 CSS pixels |
| Minimum gray on white passing 4.5:1 | #767676 |
| Metric | Good | Needs Work | Poor |
|---|---|---|---|
| LCP | ≤2.5s | 2.5s–4s | >4s |
| INP | ≤200ms | 200ms–500ms | >500ms |
| CLS | ≤0.1 | 0.1–0.25 | >0.25 |
Agent can safely fix without risk of breaking the site:
alt, aria-label, loading)Requires human judgment:
When multiple agents find the same issue:
All plugin interaction via WP-CLI options/meta, never PHP APIs:
| Operation | Command |
|---|---|
| Read plugin config | $WP option get <option_name> |
| Write plugin config | $WP option update/patch |
| Seed data | $WP post meta update |
| Complex operations | $WP eval "php code" |
| Install plugins | $WP plugin install --activate |
| Theme modifications | Direct file Edit/Write |
| wp-config changes | $WP config set |
Creates, edits, and optimizes skills for Claude Code, including drafting, evaluating with test prompts, iterating on performance, and improving skill descriptions for better triggering accuracy.
npx claudepluginhub yojahny55/claude-wp-builder --plugin claude-wp-builder