editing-blocks
Installation
SKILL.md
When to use me
Use this skill when modifying an existing block (files already exist in the workspace). Do not use this skill when creating a new block from scratch.
Editing Guidelines
- Read all existing block files before making changes — understand the current architecture, attributes, and rendering approach
- Make minimal, targeted changes — only modify what the user requested
- Only touch files that need to change — do not rewrite unrelated files
- Use the
edittool for targeted changes; only usewritewhen replacing more than 50% of a file - Do not convert between static and dynamic blocks, or change the block name/slug, unless the user explicitly asks
- When adding or modifying attributes, update all relevant files (block.json, edit.js, and save.js or render.php)
- After changes, verify the block is still registered correctly and renders on the front end
- Use the InnerBlocks component from @wordpress/block-editor as much as possible.
- When adding interactivity to an existing block, convert it to dynamic first if it isn't already (add render.php, remove save.js, add
"render": "file:./render.php"to block.json) - When converting a block to interactive: add
"viewScript": "file:./view.js"to block.json, write view.js using plain JavaScript with standard DOM APIs (querySelector, addEventListener, classList, etc.) — never use the WordPress Interactivity API