[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill-automattic-editing-blocks":3,"mdc--y507fw-key":33,"related-org-automattic-editing-blocks":227,"related-repo-automattic-editing-blocks":415},{"slug":4,"name":4,"fn":5,"description":6,"org":7,"tags":11,"stars":22,"repoUrl":23,"updatedAt":24,"license":25,"forks":26,"topics":27,"repo":28,"sourceUrl":31,"mdContent":32},"editing-blocks","modify existing WordPress blocks","Guidelines for modifying existing WordPress blocks — load this before editing block files",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},"automattic","Automattic","https:\u002F\u002Fpexgzepcugksgbtrxkhf.supabase.co\u002Fstorage\u002Fv1\u002Fobject\u002Fpublic\u002Forg-logos\u002Fautomattic.png",[12,16,19],{"name":13,"slug":14,"type":15},"Full Site Editing","full-site-editing","tag",{"name":17,"slug":18,"type":15},"WordPress","wordpress",{"name":20,"slug":21,"type":15},"Block Editor","block-editor",31,"https:\u002F\u002Fgithub.com\u002FAutomattic\u002Fdata-liberation-agent","2026-06-08T08:17:43.160336",null,1,[],{"repoUrl":23,"stars":22,"forks":26,"topics":29,"description":30},[],"Extract content from closed web platforms into WordPress-compatible WXR files.","https:\u002F\u002Fgithub.com\u002FAutomattic\u002Fdata-liberation-agent\u002Ftree\u002FHEAD\u002Fskills\u002Fediting-blocks","---\nname: editing-blocks\ndescription: Guidelines for modifying existing WordPress blocks — load this before editing block files\ndisable-model-invocation: true\n---\n\n## When to use me\n\nUse this skill when modifying an existing block (files already exist in the workspace).\nDo not use this skill when creating a new block from scratch.\n\n## Editing Guidelines\n\n- Read all existing block files before making changes — understand the current architecture, attributes, and rendering approach\n- Make minimal, targeted changes — only modify what the user requested\n- Only touch files that need to change — do not rewrite unrelated files\n- Use the `edit` tool for targeted changes; only use `write` when replacing more than 50% of a file\n- Do not convert between static and dynamic blocks, or change the block name\u002Fslug, unless the user explicitly asks\n- When adding or modifying attributes, update all relevant files (block.json, edit.js, and save.js or render.php)\n- After changes, verify the block is still registered correctly and renders on the front end\n- Use the InnerBlocks component from @wordpress\u002Fblock-editor as much as possible.\n- 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:.\u002Frender.php\"` to block.json)\n- When converting a block to interactive: add `\"viewScript\": \"file:.\u002Fview.js\"` to block.json, write view.js using plain JavaScript with standard DOM APIs (querySelector, addEventListener, classList, etc.) — never use the WordPress Interactivity API\n\n## Reference Files\n\nBefore editing block files, read the relevant references from the `references\u002F` directory next to this skill file.\n\n- **`references\u002Fartefact-templates.md`** — read this to verify correct file structure, paths, and asset references (especially register_block_type path and block.json asset filenames)\n- **`references\u002Ffile-templates.md`** — additional guidelines for each block file type\n- **`references\u002Finner-blocks.md`** — read this if the block uses InnerBlocks or child blocks\n- **`references\u002Finteractivity-api.md`** — read this when adding interactive behavior to a block that needs frontend JavaScript\n",{"data":34,"body":36},{"name":4,"description":6,"disable-model-invocation":35},true,{"type":37,"children":38},"root",[39,48,54,60,148,154,167],{"type":40,"tag":41,"props":42,"children":44},"element","h2",{"id":43},"when-to-use-me",[45],{"type":46,"value":47},"text","When to use me",{"type":40,"tag":49,"props":50,"children":51},"p",{},[52],{"type":46,"value":53},"Use this skill when modifying an existing block (files already exist in the workspace).\nDo not use this skill when creating a new block from scratch.",{"type":40,"tag":41,"props":55,"children":57},{"id":56},"editing-guidelines",[58],{"type":46,"value":59},"Editing Guidelines",{"type":40,"tag":61,"props":62,"children":63},"ul",{},[64,70,75,80,102,107,112,117,122,135],{"type":40,"tag":65,"props":66,"children":67},"li",{},[68],{"type":46,"value":69},"Read all existing block files before making changes — understand the current architecture, attributes, and rendering approach",{"type":40,"tag":65,"props":71,"children":72},{},[73],{"type":46,"value":74},"Make minimal, targeted changes — only modify what the user requested",{"type":40,"tag":65,"props":76,"children":77},{},[78],{"type":46,"value":79},"Only touch files that need to change — do not rewrite unrelated files",{"type":40,"tag":65,"props":81,"children":82},{},[83,85,92,94,100],{"type":46,"value":84},"Use the ",{"type":40,"tag":86,"props":87,"children":89},"code",{"className":88},[],[90],{"type":46,"value":91},"edit",{"type":46,"value":93}," tool for targeted changes; only use ",{"type":40,"tag":86,"props":95,"children":97},{"className":96},[],[98],{"type":46,"value":99},"write",{"type":46,"value":101}," when replacing more than 50% of a file",{"type":40,"tag":65,"props":103,"children":104},{},[105],{"type":46,"value":106},"Do not convert between static and dynamic blocks, or change the block name\u002Fslug, unless the user explicitly asks",{"type":40,"tag":65,"props":108,"children":109},{},[110],{"type":46,"value":111},"When adding or modifying attributes, update all relevant files (block.json, edit.js, and save.js or render.php)",{"type":40,"tag":65,"props":113,"children":114},{},[115],{"type":46,"value":116},"After changes, verify the block is still registered correctly and renders on the front end",{"type":40,"tag":65,"props":118,"children":119},{},[120],{"type":46,"value":121},"Use the InnerBlocks component from @wordpress\u002Fblock-editor as much as possible.",{"type":40,"tag":65,"props":123,"children":124},{},[125,127,133],{"type":46,"value":126},"When adding interactivity to an existing block, convert it to dynamic first if it isn't already (add render.php, remove save.js, add ",{"type":40,"tag":86,"props":128,"children":130},{"className":129},[],[131],{"type":46,"value":132},"\"render\": \"file:.\u002Frender.php\"",{"type":46,"value":134}," to block.json)",{"type":40,"tag":65,"props":136,"children":137},{},[138,140,146],{"type":46,"value":139},"When converting a block to interactive: add ",{"type":40,"tag":86,"props":141,"children":143},{"className":142},[],[144],{"type":46,"value":145},"\"viewScript\": \"file:.\u002Fview.js\"",{"type":46,"value":147}," to block.json, write view.js using plain JavaScript with standard DOM APIs (querySelector, addEventListener, classList, etc.) — never use the WordPress Interactivity API",{"type":40,"tag":41,"props":149,"children":151},{"id":150},"reference-files",[152],{"type":46,"value":153},"Reference Files",{"type":40,"tag":49,"props":155,"children":156},{},[157,159,165],{"type":46,"value":158},"Before editing block files, read the relevant references from the ",{"type":40,"tag":86,"props":160,"children":162},{"className":161},[],[163],{"type":46,"value":164},"references\u002F",{"type":46,"value":166}," directory next to this skill file.",{"type":40,"tag":61,"props":168,"children":169},{},[170,185,199,213],{"type":40,"tag":65,"props":171,"children":172},{},[173,183],{"type":40,"tag":174,"props":175,"children":176},"strong",{},[177],{"type":40,"tag":86,"props":178,"children":180},{"className":179},[],[181],{"type":46,"value":182},"references\u002Fartefact-templates.md",{"type":46,"value":184}," — read this to verify correct file structure, paths, and asset references (especially register_block_type path and block.json asset filenames)",{"type":40,"tag":65,"props":186,"children":187},{},[188,197],{"type":40,"tag":174,"props":189,"children":190},{},[191],{"type":40,"tag":86,"props":192,"children":194},{"className":193},[],[195],{"type":46,"value":196},"references\u002Ffile-templates.md",{"type":46,"value":198}," — additional guidelines for each block file type",{"type":40,"tag":65,"props":200,"children":201},{},[202,211],{"type":40,"tag":174,"props":203,"children":204},{},[205],{"type":40,"tag":86,"props":206,"children":208},{"className":207},[],[209],{"type":46,"value":210},"references\u002Finner-blocks.md",{"type":46,"value":212}," — read this if the block uses InnerBlocks or child blocks",{"type":40,"tag":65,"props":214,"children":215},{},[216,225],{"type":40,"tag":174,"props":217,"children":218},{},[219],{"type":40,"tag":86,"props":220,"children":222},{"className":221},[],[223],{"type":46,"value":224},"references\u002Finteractivity-api.md",{"type":46,"value":226}," — read this when adding interactive behavior to a block that needs frontend JavaScript",{"items":228,"total":414},[229,250,265,279,296,311,325,340,357,368,383,399],{"slug":230,"name":230,"fn":231,"description":232,"org":233,"tags":234,"stars":247,"repoUrl":248,"updatedAt":249},"annotate","collect visual feedback with browser annotation tools","Open a browser with visual annotation tools. The user clicks elements on their site and leaves feedback — the agent reads annotations and makes changes. Use this when the user wants to point at specific elements to fix, tweak, or redesign.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[235,238,241,244],{"name":236,"slug":237,"type":15},"Frontend","frontend",{"name":239,"slug":240,"type":15},"Productivity","productivity",{"name":242,"slug":243,"type":15},"UX Copy","ux-copy",{"name":245,"slug":246,"type":15},"UX Design","ux-design",484,"https:\u002F\u002Fgithub.com\u002FAutomattic\u002Fstudio","2026-05-06T05:40:01.516544",{"slug":251,"name":251,"fn":252,"description":253,"org":254,"tags":255,"stars":247,"repoUrl":248,"updatedAt":264},"block-content","write editable WordPress block markup","Write editable WordPress block markup for local Studio sites, including core\u002Fhtml limits, block-theme layout rules, full-width sections, validation, and skeleton-first page\u002FCSS recipes.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[256,257,260,263],{"name":20,"slug":21,"type":15},{"name":258,"slug":259,"type":15},"CSS","css",{"name":261,"slug":262,"type":15},"HTML","html",{"name":17,"slug":18,"type":15},"2026-05-27T07:01:55.629681",{"slug":266,"name":266,"fn":267,"description":268,"org":269,"tags":270,"stars":247,"repoUrl":248,"updatedAt":278},"hosting-plans-helper","provide WordPress.com hosting plan information","Answer WordPress.com plan, pricing, upgrade, and feature-tier questions (plan names, what each tier unlocks — plugins, themes, custom code, SSH, hosting — and current prices) from authoritative live data. Load before answering ANY plan, pricing, or feature-gating question; never answer these from memory.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[271,274,277],{"name":272,"slug":273,"type":15},"Pricing","pricing",{"name":275,"slug":276,"type":15},"Reference","reference",{"name":17,"slug":18,"type":15},"2026-07-02T07:42:33.654791",{"slug":280,"name":280,"fn":281,"description":282,"org":283,"tags":284,"stars":247,"repoUrl":248,"updatedAt":295},"liberate","migrate websites to WordPress","Import and rebuild a website from a closed platform (Wix, Squarespace, Webflow, Shopify, GoDaddy, Hostinger, HubSpot, Weebly) into a Studio WordPress site. Extracts pages\u002Fposts\u002Fproducts + media, then reconstructs the design as editable blocks + WooCommerce OR as a high-fidelity replica theme. Invoke when the user wants to migrate, import, liberate, or rebuild a site from one of these platforms.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[285,288,291,294],{"name":286,"slug":287,"type":15},"CMS","cms",{"name":289,"slug":290,"type":15},"Migration","migration",{"name":292,"slug":293,"type":15},"Web Development","web-development",{"name":17,"slug":18,"type":15},"2026-07-09T06:47:33.454311",{"slug":297,"name":297,"fn":298,"description":299,"org":300,"tags":301,"stars":247,"repoUrl":248,"updatedAt":310},"need-for-speed","run frontend performance audits for WordPress sites","Run a frontend performance audit on a WordPress site and get actionable optimization recommendations.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[302,305,306,309],{"name":303,"slug":304,"type":15},"Audit","audit",{"name":236,"slug":237,"type":15},{"name":307,"slug":308,"type":15},"Performance","performance",{"name":17,"slug":18,"type":15},"2026-05-06T05:40:06.433267",{"slug":312,"name":312,"fn":313,"description":314,"org":315,"tags":316,"stars":247,"repoUrl":248,"updatedAt":324},"plugin-recommendations","recommend WordPress plugins for site features","Choose recommended plugins and plugin-provided blocks for features core WordPress blocks do not cover - ecommerce (WooCommerce), forms and newsletters (Jetpack), online courses and quizzes (Sensei LMS), polls, surveys and ratings (Crowdsignal), spam protection (Akismet) - while keeping generated content editable and avoiding raw HTML fallbacks. Any request to sell products or build a shop, store, or storefront requires WooCommerce with products.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[317,320,323],{"name":318,"slug":319,"type":15},"Content Creation","content-creation",{"name":321,"slug":322,"type":15},"Plugin Development","plugin-development",{"name":17,"slug":18,"type":15},"2026-05-27T07:01:58.249105",{"slug":326,"name":326,"fn":327,"description":328,"org":329,"tags":330,"stars":247,"repoUrl":248,"updatedAt":339},"rank-me-up","run on-page SEO audits for WordPress sites","Run an on-page SEO audit on a WordPress site and get actionable recommendations to improve search visibility.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[331,332,335,338],{"name":303,"slug":304,"type":15},{"name":333,"slug":334,"type":15},"Marketing","marketing",{"name":336,"slug":337,"type":15},"SEO","seo",{"name":17,"slug":18,"type":15},"2026-05-06T05:40:05.196367",{"slug":341,"name":341,"fn":342,"description":343,"org":344,"tags":345,"stars":247,"repoUrl":248,"updatedAt":356},"site-spec","gather specifications for new WordPress sites","Gather the site name and layout preference before building a WordPress site. Run this before creating any new site.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[346,349,352,355],{"name":347,"slug":348,"type":15},"Design","design",{"name":350,"slug":351,"type":15},"Product Management","product-management",{"name":353,"slug":354,"type":15},"Specs","specs",{"name":17,"slug":18,"type":15},"2026-05-06T05:40:02.739409",{"slug":358,"name":358,"fn":359,"description":360,"org":361,"tags":362,"stars":247,"repoUrl":248,"updatedAt":367},"studio-cli","manage local WordPress sites with Studio CLI","Use the Studio CLI to manage local WordPress sites, authentication, and preview sites. Invoke this skill when you need to run Studio CLI commands, manage sites, or troubleshoot site issues.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[363,366],{"name":364,"slug":365,"type":15},"CLI","cli",{"name":17,"slug":18,"type":15},"2026-04-06T18:02:57.150231",{"slug":369,"name":369,"fn":370,"description":371,"org":372,"tags":373,"stars":247,"repoUrl":248,"updatedAt":382},"taxonomist","optimize WordPress category taxonomy","Analyze and optimize a WordPress site's category taxonomy. Exports all posts, uses AI to suggest an improved category structure — merging duplicates, retiring dead categories, creating missing ones, writing descriptions, and re-categorizing posts. Run this when the user wants to clean up or improve their categories.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[374,377,380,381],{"name":375,"slug":376,"type":15},"Content Strategy","content-strategy",{"name":378,"slug":379,"type":15},"Data Cleaning","data-cleaning",{"name":336,"slug":337,"type":15},{"name":17,"slug":18,"type":15},"2026-05-06T05:40:03.966799",{"slug":384,"name":384,"fn":385,"description":386,"org":387,"tags":388,"stars":247,"repoUrl":248,"updatedAt":398},"visual-design","plan and execute visual design direction","Plan and execute high-quality visual direction for site creation, redesign, layout, typography, color, motion, and visual polish.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[389,392,393,396],{"name":390,"slug":391,"type":15},"Animation","animation",{"name":347,"slug":348,"type":15},{"name":394,"slug":395,"type":15},"Typography","typography",{"name":397,"slug":384,"type":15},"Visual Design","2026-07-24T05:40:57.887452",{"slug":400,"name":400,"fn":401,"description":402,"org":403,"tags":404,"stars":247,"repoUrl":248,"updatedAt":413},"visual-polish","verify and polish website visual design","Verify and polish a built or redesigned site by diagnosing rendered-DOM issues against intent and fixing them in a planned, batched screenshot-and-fix loop.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[405,408,409,412],{"name":406,"slug":407,"type":15},"Debugging","debugging",{"name":236,"slug":237,"type":15},{"name":410,"slug":411,"type":15},"Screenshots","screenshots",{"name":397,"slug":384,"type":15},"2026-06-06T07:09:59.809812",81,{"items":416,"total":511},[417,432,443,454,467,482,498],{"slug":418,"name":418,"fn":419,"description":420,"org":421,"tags":422,"stars":22,"repoUrl":23,"updatedAt":431},"adapt","build platform adapters for content extraction","Build a new platform adapter to extract content from an unsupported platform (Blogger, Ghost, Tumblr, etc.)",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[423,426,427,430],{"name":424,"slug":425,"type":15},"Automation","automation",{"name":378,"slug":379,"type":15},{"name":428,"slug":429,"type":15},"Data Engineering","data-engineering",{"name":17,"slug":18,"type":15},"2026-05-09T05:32:13.987972",{"slug":433,"name":433,"fn":434,"description":435,"org":436,"tags":437,"stars":22,"repoUrl":23,"updatedAt":442},"compose-page-blocks","compose WordPress block markup from HTML","Compose a single liberated page's WordPress block-editor markup from its rendered HTML and screenshot. Inputs are a sanitized HTML file, a desktop screenshot, the design-foundation tokens, the URL's archetype (page\u002Fpost\u002Fproduct\u002Fetc.), and the source URL. Output is a string of valid block markup that round-trips through parse_blocks, uses theme tokens (no inlined hex colors), and contains only text drawn from the source HTML. Call per-page during the streaming watch loop after extraction has produced HTML+screenshot for that URL. Use when a freshly-imported page needs `post_content` upgraded from raw HTML into block-editor markup so the replica theme's tokens, gradients, and patterns actually render.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[438,439,440,441],{"name":20,"slug":21,"type":15},{"name":318,"slug":319,"type":15},{"name":261,"slug":262,"type":15},{"name":17,"slug":18,"type":15},"2026-06-08T08:17:34.212397",{"slug":444,"name":444,"fn":445,"description":446,"org":447,"tags":448,"stars":22,"repoUrl":23,"updatedAt":453},"creating-blocks","create new WordPress blocks","Templates and guidelines for creating new WordPress blocks from scratch — load this before generating block files",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[449,450,451,452],{"name":20,"slug":21,"type":15},{"name":13,"slug":14,"type":15},{"name":321,"slug":322,"type":15},{"name":17,"slug":18,"type":15},"2026-06-08T08:17:49.413995",{"slug":455,"name":455,"fn":456,"description":457,"org":458,"tags":459,"stars":22,"repoUrl":23,"updatedAt":466},"creating-themes","create WordPress block themes","Guidelines for creating new WordPress block themes from scratch — load this before generating theme files",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[460,461,462,465],{"name":20,"slug":21,"type":15},{"name":13,"slug":14,"type":15},{"name":463,"slug":464,"type":15},"Themes","themes",{"name":17,"slug":18,"type":15},"2026-06-08T08:17:50.666611",{"slug":468,"name":468,"fn":469,"description":470,"org":471,"tags":472,"stars":22,"repoUrl":23,"updatedAt":481},"design-foundations","build design foundation JSON from sites","Build a coherent design-foundation JSON from a liberated site — semantic color\u002Ftypography\u002Fspacing roles with evidence trails. Consumes the partial scaffold produced by liberate_design_foundation_scaffold plus aggregate HTML\u002FCSS analysis and representative rendered HTML; produces a complete design-foundation matching the schema. Call after liberation, before theme generation.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[473,476,477,480],{"name":474,"slug":475,"type":15},"Data Modeling","data-modeling",{"name":347,"slug":348,"type":15},{"name":478,"slug":479,"type":15},"Design System","design-system",{"name":236,"slug":237,"type":15},"2026-06-08T08:17:44.457834",{"slug":483,"name":483,"fn":484,"description":485,"org":486,"tags":487,"stars":22,"repoUrl":23,"updatedAt":497},"design-qa","run visual QA on WordPress themes","Visual-QA loop run after replica theme install and content import. Captures replica screenshots, applies a hard responsiveness gate at 390px AND a hard per-section visual-parity gate (measured SectionParity records, verdict computed by buildRunReport), runs qualitative vision review of source\u002Freplica pairs, checks accessibility, and drives a per-section escalation ladder of fixes via editing-themes\u002Fediting-blocks\u002Frebuild-section (R1 CSS → R2 spec-rebuild → R3 re-extract → R4a AI canonical-block rebuild → R4b deterministic styled-island floor) — escalating unresolved divergences to the operator rather than shipping them. Orchestration-internal — invoked by the replicate-with-blocks\u002Fliberate orchestrators, not directly by users.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[488,491,492,495,496],{"name":489,"slug":490,"type":15},"QA","qa",{"name":410,"slug":411,"type":15},{"name":493,"slug":494,"type":15},"Testing","testing",{"name":463,"slug":464,"type":15},{"name":17,"slug":18,"type":15},"2026-06-08T08:17:45.698278",{"slug":499,"name":499,"fn":500,"description":501,"org":502,"tags":503,"stars":22,"repoUrl":23,"updatedAt":510},"diagnose","debug failed data extraction processes","Debug failed or low-quality extractions by analyzing logs, probing the source site, and identifying root causes",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[504,505,506,509],{"name":428,"slug":429,"type":15},{"name":406,"slug":407,"type":15},{"name":507,"slug":508,"type":15},"Logs","logs",{"name":489,"slug":490,"type":15},"2026-05-10T05:48:11.267642",21]