orbit-block-json-validatelisted
Install: claude install-skill adityaarsharma/orbit
# 🪐 orbit-block-json-validate — block.json schema validator
WP 6.5 made `apiVersion: 3` the standard. WP 6.4 and earlier supported apiVersion 2. Older plugins ship apiVersion 1 — which now warns. This skill catches every schema issue.
---
## Quick start
```bash
bash ~/Claude/orbit/scripts/check-block-json.sh ~/plugins/my-plugin
```
Output: `reports/block-json-<timestamp>.md`.
---
## What it checks
### 1. Required fields
```json
{
"$schema": "https://schemas.wp.org/trunk/block.json",
"apiVersion": 3, // 3 (WP 6.5+) or 2 (back-compat)
"name": "my-plugin/example", // namespace/name format
"version": "1.0.0",
"title": "Example Block",
"description": "What it does.",
"category": "widgets",
"icon": "smiley",
"keywords": ["example"],
"textdomain": "my-plugin",
"attributes": { ... },
"supports": { ... },
"render": "file:./render.php", // server-side render (WP 6.1+)
"editorScript": "file:./build/index.js",
"editorStyle": "file:./build/index.css",
"style": "file:./build/style-index.css",
"viewScriptModule": "file:./build/view.js", // ES module (WP 6.5+)
"viewScript": "file:./build/view.js" // legacy (use module above)
}
```
### 2. Name format
Must be `namespace/blockname` — lowercase, dashes only, no underscores or camelCase.
- ✅ `my-plugin/example-block`
- ❌ `my_plugin/example` (underscore)
- ❌ `MyPlugin/Example` (camelCase)
### 3. apiVersion
- 1: Deprecated. WP shows a warning. Migrate to 3.
- 2