{
  "markdown": "# WP Blocks Dev\n\nA **[Claude Code](https://claude.ai/code) plugin** for scaffolding, auditing, and managing custom ACF Gutenberg blocks for WordPress — with Tailwind CSS integration and a structured, production-ready workflow.\n\n## Install\n\n**From GitHub:**\n\n```bash\nclaude plugin marketplace add phucbm/wp-blocks-dev\nclaude plugin install wp-blocks-dev@phucbm --scope project\n```\n\n## Update\n\n```bash\nclaude plugin update wp-blocks-dev@phucbm\n```\n\n> Always bump `version` in `.claude-plugin/plugin.json` when publishing — Claude Code uses it to detect updates.\n\n---\n\n## Skills\n\n| Skill | Example prompt | What it does |\n|---|---|---|\n| `/wp-blocks-dev:init` | `/wp-blocks-dev:init my-client-site` | Scaffold a new WordPress theme — asks for project name, slug, author, and optional features (Tailwind, TypeScript), then creates the full theme structure |\n| `/wp-blocks-dev:create-block` | `/wp-blocks-dev:create-block hero-banner` | Scaffold a new ACF block — generates `block.json`, `fields.json`, `render.php`, and registers it in `blocks.json` |\n| `/wp-blocks-dev:audit-blocks` | `/wp-blocks-dev:audit-blocks` | Fast structural audit — checks all blocks for missing files, invalid timestamps, unregistered folders. No AI, runs in seconds |\n| `/wp-blocks-dev:audit-blocks-deep` | `/wp-blocks-dev:audit-blocks-deep` | Deep AI audit — reviews block labels, field quality, admin render justification, and empty-state messages across the project |\n\n## Agent\n\n| Agent | Example prompt | What it does |\n|---|---|---|\n| `wp-blocks-dev` | `@wp-blocks-dev should this block have render-admin.php?` | Expert on the full stack — ask anything about block structure, ACF fields, PHP patterns, asset loading, or Tailwind. No context needed, it knows the workflow. |\n\n## Hooks\n\n| Hook | Trigger | What it does |\n|---|---|---|\n| `fields.json` reminder | Any edit or write to `fields.json` | Reminds you to run `date +%s` and update the `modified` timestamp — ACF uses this for field group sync detection |\n\n---\n\n## Required mu-plugins\n\nInstall all three from [phucbm/wp-mu-plugins](https://github.com/phucbm/wp-mu-plugins) into your `mu-plugins/` directory:\n\n| File | Purpose |\n|---|---|\n| [`acf-local-json-router.php`](https://github.com/phucbm/wp-mu-plugins/blob/main/acf-local-json-router.php) | Routes ACF JSON saves per-block to `blocks/{slug}/fields.json` |\n| [`wp-blocks-loader.php`](https://github.com/phucbm/wp-mu-plugins/blob/main/wp-blocks-loader.php) | Registers blocks from `blocks.json`, adds block category, fixes WP 6.3+ script defer |\n| [`tailwind-theme-loader.php`](https://github.com/phucbm/wp-mu-plugins/blob/main/tailwind-theme-loader.php) | Enqueues Tailwind CSS on frontend and in the block editor |\n\n---\n\n## Requirements\n\n- WordPress 6.0+\n- ACF Pro\n- PHP 8.0+\n- Node.js + pnpm (if using Tailwind or TypeScript)\n\n## License\n\nMIT — [phucbm](https://github.com/phucbm)\n",
  "bytes": 2875,
  "sha": "d8bcca7bc58f450fce47bf6760eb73f7ea9594e2faeed1a27a995b6b9ef6e03c",
  "repo_slug": "perxel/perxel-blocks",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_perxel_perxel_blocks_perxel_blocks_cbb150b4/readme"
}