wp-contributing SKILL.md skillA

wp-contributing from yojahny55/claude-wp-builder is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add yojahny55/claude-wp-builder/wp-contributing@git:20261023.50f84b2

Pins git:20261023.50f84b2 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
yojahny55/claude-wp-builder
Path
skills/wp-contributing/SKILL.md
Versions recorded
8
Latest version
git:20261023.50f84b2, committed Oct 23, 2026
First version recorded
Sep 2, 2026
Size
15,066 bytes
Repository stars
6
License
MIT

Documents how to change the claude-wp-builder plugin itself — the four-layer architecture (commands, agents, skills, starter-theme) and what may call what, why checks in tests/checks/ are grep gates over prose, the frontmatter contract per layer, the two i18n systems, opening a PR, and what a release rests on. Use when editing this repository's own commands/, agents/, skills/, starter-theme/, bin/ or tests/, when writing a check, opening a PR, cutting a release or editing CHANGELOG.md…

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Contributing to Claude WP Builder

`CONTRIBUTING.md` is the front door: how to fork, where files go, the PR template, the code
of conduct. Read it first. This skill is the part that is not written down anywhere else —
the rules you only learn by breaking them.

**The one sentence that explains this repo:** it is a plugin made almost entirely of prose,
so nothing fails at runtime when the prose goes wrong. A contract that drifts produces a
worse site, silently, three commands later. Every convention below exists because that
already happened.

---

## Part 1 — Contributors

### The four layers, and what may call what

```
commands/*.md     user-facing slash commands — orchestration, argument parsing, step order
   ↓ dispatches
agents/*.md       specialized subagents (wp-template, wp-css, wp-acf, wp-audit-*, …)
   ↓ reads
skills/*/SKILL.md knowledge libraries — methodology, never actions
   ↓ produces
starter-theme/    PHP scaffolds copied into the user's project
```

Calls go **down** only. The rules that follow from that:

- **A command must never reimplement a builder.** `/wp-yolo` is the model: it normalizes the
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add yojahny55/claude-wp-builder/wp-contributing@sha256:8d108279caeca8b4

The line at the top of this page pins the label git:20261023.50f84b2, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_6vlxvlkztinsaivz.svg)](https://markdownregistry.com/a/art_6vlxvlkztinsaivz)

7 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 8 versions of this file, between Sep 2, 2026 and Oct 23, 2026, about one every 7 days.

versioncommittedcommitsizeaudit
git:20261023.50f84b2 latest2026-10-23 50f84b2 15,066 BA view · diff
git:20261022.df7784c2026-10-22 df7784c 14,667 BA view · diff
git:20261009.e624dbe2026-10-09 e624dbe 14,343 BA view · diff
git:20261006.ec80a722026-10-06 ec80a72 14,317 BA view · diff
git:20261006.3256c652026-10-06 3256c65 13,407 BA view · diff
git:20261006.b7b24e02026-10-06 b7b24e0 12,473 BA view · diff
git:20261006.2c6b6242026-10-06 2c6b624 12,299 BA view · diff
git:20260902.cc9089c2026-09-02 cc9089c 11,729 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (15066 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

yojahny55/claude-wp-builder · 6 stars · license MIT · pushed 2026-11-03 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_6vlxvlkztinsaivz
GET https://markdownregistry.com/api/v1/resolve?ref=yojahny55/claude-wp-builder/wp-contributing
GET https://markdownregistry.com/api/v1/blob/8d108279caeca8b40ad40b5f01a31cf251a437e863a68400888d33e1d4d3ece5

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from yojahny55/claude-wp-builder

CLAUDE.md CLAUDE.md file
yojahny55/claude-wp-builder · CLAUDE.md
git:20261029.0b5da21 · audit A · 6 stars
wp-aos-animator SKILL.md skill
yojahny55/claude-wp-builder · skills/wp-aos-animator/SKILL.md · Installs AOS (Animate On Scroll) into a plain-mode WordPress theme and adds data-aos entrance animations across its…
git:20261006.0fc7f12 · audit B · 6 stars
wp-audit-geo-standards SKILL.md skill
yojahny55/claude-wp-builder · skills/wp-audit-geo-standards/SKILL.md · GEO and AI-agent-readiness reference — the ORA and is-agentic scoring model, the GEO-D, GEO-A, GEO-U and GEO-P check…
git:20261029.8110832 · audit A · 6 stars
wp-audit-local-standards SKILL.md skill
yojahny55/claude-wp-builder · skills/wp-audit-local-standards/SKILL.md · Criteria for the local-SEO audit checks SEO-055 to SEO-063 — the two-signal applicability gate, brick-and-mortar…
git:20261006.b4403b0 · audit A · 6 stars
wp-audit-run SKILL.md skill
yojahny55/claude-wp-builder · skills/wp-audit-run/SKILL.md · The step detail of the /wp-audit run, split out of commands/wp-audit.md so the command stays a short map — site type…
git:20261029.0e75036 · audit A · 6 stars
wp-audit-seo-standards SKILL.md skill
yojahny55/claude-wp-builder · skills/wp-audit-seo-standards/SKILL.md · Rank Math SEO reference for WordPress — detecting the plugin, the module, option and post meta keys…
git:20261006.b4403b0 · audit A · 6 stars
wp-audit-standards SKILL.md skill
yojahny55/claude-wp-builder · skills/wp-audit-standards/SKILL.md · Shared contract for every wp-audit-* agent — severity levels, the report fields bin/audit-report.mjs reads (check…
git:20261029.8c41200 · audit A · 6 stars
wp-audit-ux-standards SKILL.md skill
yojahny55/claude-wp-builder · skills/wp-audit-ux-standards/SKILL.md · The UX-NNN usability catalog for a WordPress site — forms and data entry, navigation and task flow, broken internal and…
git:20261006.b4403b0 · audit A · 6 stars
wp-bilingual SKILL.md skill
yojahny55/claude-wp-builder · skills/wp-bilingual/SKILL.md · Documents the suffix i18n model — one page carries every language, with ACF/SCF fields duplicated as _lang suffixes…
git:20261006.3d44a76 · audit A · 6 stars
wp-cli-patterns SKILL.md skill
yojahny55/claude-wp-builder · skills/wp-cli-patterns/SKILL.md · WP-CLI-first rules for seeding and diagnosing a WordPress site — run WP-CLI instead of generating PHP, the $WP wrapper…
git:20261029.e39bf72 · audit A · 6 stars
wp-clone-run SKILL.md skill
yojahny55/claude-wp-builder · skills/wp-clone-run/SKILL.md · The step detail of the /wp-clone run, split out of commands/wp-clone.md so the command stays a short map — Path A (SSH…
git:20261016.0b20db9 · audit A · 6 stars
wp-create-run SKILL.md skill
yojahny55/claude-wp-builder · skills/wp-create-run/SKILL.md · The step detail of the /wp-create run, split out of commands/wp-create.md so the command stays a short map — the…
git:20261010.5495bb9 · audit A · 6 stars

Every file in yojahny55/claude-wp-builder

Browse by kind, by grade A, or by owner.