[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill-automattic-site-spec":3,"mdc-pywlgs-key":40,"related-repo-automattic-site-spec":240,"related-org-automattic-site-spec":353},{"slug":4,"name":4,"fn":5,"description":6,"org":7,"tags":11,"stars":25,"repoUrl":26,"updatedAt":27,"license":28,"forks":29,"topics":30,"repo":35,"sourceUrl":38,"mdContent":39},"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},"automattic","Automattic","https:\u002F\u002Fpexgzepcugksgbtrxkhf.supabase.co\u002Fstorage\u002Fv1\u002Fobject\u002Fpublic\u002Forg-logos\u002Fautomattic.png",[12,16,19,22],{"name":13,"slug":14,"type":15},"Specs","specs","tag",{"name":17,"slug":18,"type":15},"WordPress","wordpress",{"name":20,"slug":21,"type":15},"Product Management","product-management",{"name":23,"slug":24,"type":15},"Design","design",484,"https:\u002F\u002Fgithub.com\u002FAutomattic\u002Fstudio","2026-05-06T05:40:02.739409",null,82,[31,32,33,34,18],"agents","cli","desktop","electron",{"repoUrl":26,"stars":25,"forks":29,"topics":36,"description":37},[31,32,33,34,18],"WordPress Studio, a free desktop app and CLI that helps developers streamline their local WordPress development workflow.","https:\u002F\u002Fgithub.com\u002FAutomattic\u002Fstudio\u002Ftree\u002FHEAD\u002Fapps\u002Fcli\u002Fai\u002Fskills\u002Fsite-spec","---\nname: site-spec\ndescription: Gather the site name and layout preference before building a WordPress site. Run this before creating any new site.\nuser-invokable: true\n---\n\n# Site Spec Discovery\n\nBefore creating a new WordPress site, gather the user's basic preferences through a short interactive discovery phase. This produces a **Site Spec** that guides all subsequent design and development decisions.\n\n## How to Run\n\nGather preferences through 2 rounds. Keep it concise.\n\n**AskUserQuestion constraints**: Each call supports 1-4 questions, each with 2-4 options. An \"Other\" free-form option is automatically provided by the system — do NOT add one yourself. Keep option labels short (1-5 words). Only use AskUserQuestion for questions that have meaningful predefined options. For open-ended questions (like asking for a name), just ask in your text output — the user will type their answer in the prompt.\n\n### Round 1 — Name\n\nAsk the user for their business\u002Fsite name in your text output. **Stop here and wait for their reply** — do NOT call any tools or continue to the next round. The user needs a chance to type their answer in the prompt.\n\n### Round 2 — Layout\n\nAfter the user provides the name, use AskUserQuestion for:\n- One-page site or multi-page site? (e.g., single scrollable page with sections vs. separate pages for each area)\n\n## After Gathering Answers\n\nCall `site_create` with the provided name and use the layout preference to guide all subsequent design decisions.\n\nState the plan as a short **Site Spec** summary before building, alongside the design direction. The summary MUST include a **Functionality & plugins** line: review the requested features, load the `plugin-recommendations` skill, and list the specific plugins the site needs — e.g. WooCommerce for selling products, Jetpack Forms for a contact form, Jetpack Newsletter for email signups, Sensei LMS for courses, Crowdsignal for polls\u002Fsurveys — or \"None — core blocks only\" when nothing beyond static content is required. Install the listed plugins while building (Workflow Step 4); do not silently hand-build static markup for a feature a plugin should provide.\n\n## After site_create returns\n\nThe turn immediately after `site_create` is the biggest source of perceived hangs. Acknowledge the site in ≤2 lines of prose, then make your next tool call a small one — `site_info`, or a single ≤50-line first `Write`. Do NOT scaffold the theme, chain multiple Writes, or write a long design-plan essay in this turn. Grow the build across many small turns (see the \"Working cadence\" section of the system prompt).\n\n## When to Skip Discovery\n\nSkipping means skipping the interactive questions only — still produce the Site Spec summary (including the Functionality & plugins line) before building. Do NOT ask questions if:\n- The user already provided the name and layout preference in the initial prompt. Proceed directly with site creation.\n- The user says \"just build something\" or \"surprise me\". Pick a bold creative direction yourself and proceed.\n- The user explicitly asks to skip the setup or says they don't want questions.\n",{"data":41,"body":43},{"name":4,"description":6,"user-invokable":42},true,{"type":44,"children":45},"root",[46,55,69,76,81,91,98,110,116,121,131,137,151,177,183,211,217,222],{"type":47,"tag":48,"props":49,"children":51},"element","h1",{"id":50},"site-spec-discovery",[52],{"type":53,"value":54},"text","Site Spec Discovery",{"type":47,"tag":56,"props":57,"children":58},"p",{},[59,61,67],{"type":53,"value":60},"Before creating a new WordPress site, gather the user's basic preferences through a short interactive discovery phase. This produces a ",{"type":47,"tag":62,"props":63,"children":64},"strong",{},[65],{"type":53,"value":66},"Site Spec",{"type":53,"value":68}," that guides all subsequent design and development decisions.",{"type":47,"tag":70,"props":71,"children":73},"h2",{"id":72},"how-to-run",[74],{"type":53,"value":75},"How to Run",{"type":47,"tag":56,"props":77,"children":78},{},[79],{"type":53,"value":80},"Gather preferences through 2 rounds. Keep it concise.",{"type":47,"tag":56,"props":82,"children":83},{},[84,89],{"type":47,"tag":62,"props":85,"children":86},{},[87],{"type":53,"value":88},"AskUserQuestion constraints",{"type":53,"value":90},": Each call supports 1-4 questions, each with 2-4 options. An \"Other\" free-form option is automatically provided by the system — do NOT add one yourself. Keep option labels short (1-5 words). Only use AskUserQuestion for questions that have meaningful predefined options. For open-ended questions (like asking for a name), just ask in your text output — the user will type their answer in the prompt.",{"type":47,"tag":92,"props":93,"children":95},"h3",{"id":94},"round-1-name",[96],{"type":53,"value":97},"Round 1 — Name",{"type":47,"tag":56,"props":99,"children":100},{},[101,103,108],{"type":53,"value":102},"Ask the user for their business\u002Fsite name in your text output. ",{"type":47,"tag":62,"props":104,"children":105},{},[106],{"type":53,"value":107},"Stop here and wait for their reply",{"type":53,"value":109}," — do NOT call any tools or continue to the next round. The user needs a chance to type their answer in the prompt.",{"type":47,"tag":92,"props":111,"children":113},{"id":112},"round-2-layout",[114],{"type":53,"value":115},"Round 2 — Layout",{"type":47,"tag":56,"props":117,"children":118},{},[119],{"type":53,"value":120},"After the user provides the name, use AskUserQuestion for:",{"type":47,"tag":122,"props":123,"children":124},"ul",{},[125],{"type":47,"tag":126,"props":127,"children":128},"li",{},[129],{"type":53,"value":130},"One-page site or multi-page site? (e.g., single scrollable page with sections vs. separate pages for each area)",{"type":47,"tag":70,"props":132,"children":134},{"id":133},"after-gathering-answers",[135],{"type":53,"value":136},"After Gathering Answers",{"type":47,"tag":56,"props":138,"children":139},{},[140,142,149],{"type":53,"value":141},"Call ",{"type":47,"tag":143,"props":144,"children":146},"code",{"className":145},[],[147],{"type":53,"value":148},"site_create",{"type":53,"value":150}," with the provided name and use the layout preference to guide all subsequent design decisions.",{"type":47,"tag":56,"props":152,"children":153},{},[154,156,160,162,167,169,175],{"type":53,"value":155},"State the plan as a short ",{"type":47,"tag":62,"props":157,"children":158},{},[159],{"type":53,"value":66},{"type":53,"value":161}," summary before building, alongside the design direction. The summary MUST include a ",{"type":47,"tag":62,"props":163,"children":164},{},[165],{"type":53,"value":166},"Functionality & plugins",{"type":53,"value":168}," line: review the requested features, load the ",{"type":47,"tag":143,"props":170,"children":172},{"className":171},[],[173],{"type":53,"value":174},"plugin-recommendations",{"type":53,"value":176}," skill, and list the specific plugins the site needs — e.g. WooCommerce for selling products, Jetpack Forms for a contact form, Jetpack Newsletter for email signups, Sensei LMS for courses, Crowdsignal for polls\u002Fsurveys — or \"None — core blocks only\" when nothing beyond static content is required. Install the listed plugins while building (Workflow Step 4); do not silently hand-build static markup for a feature a plugin should provide.",{"type":47,"tag":70,"props":178,"children":180},{"id":179},"after-site_create-returns",[181],{"type":53,"value":182},"After site_create returns",{"type":47,"tag":56,"props":184,"children":185},{},[186,188,193,195,201,203,209],{"type":53,"value":187},"The turn immediately after ",{"type":47,"tag":143,"props":189,"children":191},{"className":190},[],[192],{"type":53,"value":148},{"type":53,"value":194}," is the biggest source of perceived hangs. Acknowledge the site in ≤2 lines of prose, then make your next tool call a small one — ",{"type":47,"tag":143,"props":196,"children":198},{"className":197},[],[199],{"type":53,"value":200},"site_info",{"type":53,"value":202},", or a single ≤50-line first ",{"type":47,"tag":143,"props":204,"children":206},{"className":205},[],[207],{"type":53,"value":208},"Write",{"type":53,"value":210},". Do NOT scaffold the theme, chain multiple Writes, or write a long design-plan essay in this turn. Grow the build across many small turns (see the \"Working cadence\" section of the system prompt).",{"type":47,"tag":70,"props":212,"children":214},{"id":213},"when-to-skip-discovery",[215],{"type":53,"value":216},"When to Skip Discovery",{"type":47,"tag":56,"props":218,"children":219},{},[220],{"type":53,"value":221},"Skipping means skipping the interactive questions only — still produce the Site Spec summary (including the Functionality & plugins line) before building. Do NOT ask questions if:",{"type":47,"tag":122,"props":223,"children":224},{},[225,230,235],{"type":47,"tag":126,"props":226,"children":227},{},[228],{"type":53,"value":229},"The user already provided the name and layout preference in the initial prompt. Proceed directly with site creation.",{"type":47,"tag":126,"props":231,"children":232},{},[233],{"type":53,"value":234},"The user says \"just build something\" or \"surprise me\". Pick a bold creative direction yourself and proceed.",{"type":47,"tag":126,"props":236,"children":237},{},[238],{"type":53,"value":239},"The user explicitly asks to skip the setup or says they don't want questions.",{"items":241,"total":352},[242,261,278,292,309,324,337],{"slug":243,"name":243,"fn":244,"description":245,"org":246,"tags":247,"stars":25,"repoUrl":26,"updatedAt":260},"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},[248,251,254,257],{"name":249,"slug":250,"type":15},"Frontend","frontend",{"name":252,"slug":253,"type":15},"Productivity","productivity",{"name":255,"slug":256,"type":15},"UX Copy","ux-copy",{"name":258,"slug":259,"type":15},"UX Design","ux-design","2026-05-06T05:40:01.516544",{"slug":262,"name":262,"fn":263,"description":264,"org":265,"tags":266,"stars":25,"repoUrl":26,"updatedAt":277},"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},[267,270,273,276],{"name":268,"slug":269,"type":15},"Block Editor","block-editor",{"name":271,"slug":272,"type":15},"CSS","css",{"name":274,"slug":275,"type":15},"HTML","html",{"name":17,"slug":18,"type":15},"2026-05-27T07:01:55.629681",{"slug":279,"name":279,"fn":280,"description":281,"org":282,"tags":283,"stars":25,"repoUrl":26,"updatedAt":291},"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},[284,287,290],{"name":285,"slug":286,"type":15},"Pricing","pricing",{"name":288,"slug":289,"type":15},"Reference","reference",{"name":17,"slug":18,"type":15},"2026-07-02T07:42:33.654791",{"slug":293,"name":293,"fn":294,"description":295,"org":296,"tags":297,"stars":25,"repoUrl":26,"updatedAt":308},"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},[298,301,304,307],{"name":299,"slug":300,"type":15},"CMS","cms",{"name":302,"slug":303,"type":15},"Migration","migration",{"name":305,"slug":306,"type":15},"Web Development","web-development",{"name":17,"slug":18,"type":15},"2026-07-09T06:47:33.454311",{"slug":310,"name":310,"fn":311,"description":312,"org":313,"tags":314,"stars":25,"repoUrl":26,"updatedAt":323},"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},[315,318,319,322],{"name":316,"slug":317,"type":15},"Audit","audit",{"name":249,"slug":250,"type":15},{"name":320,"slug":321,"type":15},"Performance","performance",{"name":17,"slug":18,"type":15},"2026-05-06T05:40:06.433267",{"slug":174,"name":174,"fn":325,"description":326,"org":327,"tags":328,"stars":25,"repoUrl":26,"updatedAt":336},"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},[329,332,335],{"name":330,"slug":331,"type":15},"Content Creation","content-creation",{"name":333,"slug":334,"type":15},"Plugin Development","plugin-development",{"name":17,"slug":18,"type":15},"2026-05-27T07:01:58.249105",{"slug":338,"name":338,"fn":339,"description":340,"org":341,"tags":342,"stars":25,"repoUrl":26,"updatedAt":351},"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},[343,344,347,350],{"name":316,"slug":317,"type":15},{"name":345,"slug":346,"type":15},"Marketing","marketing",{"name":348,"slug":349,"type":15},"SEO","seo",{"name":17,"slug":18,"type":15},"2026-05-06T05:40:05.196367",13,{"items":354,"total":465},[355,362,369,375,382,389,395,402,409,419,434,450],{"slug":243,"name":243,"fn":244,"description":245,"org":356,"tags":357,"stars":25,"repoUrl":26,"updatedAt":260},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[358,359,360,361],{"name":249,"slug":250,"type":15},{"name":252,"slug":253,"type":15},{"name":255,"slug":256,"type":15},{"name":258,"slug":259,"type":15},{"slug":262,"name":262,"fn":263,"description":264,"org":363,"tags":364,"stars":25,"repoUrl":26,"updatedAt":277},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[365,366,367,368],{"name":268,"slug":269,"type":15},{"name":271,"slug":272,"type":15},{"name":274,"slug":275,"type":15},{"name":17,"slug":18,"type":15},{"slug":279,"name":279,"fn":280,"description":281,"org":370,"tags":371,"stars":25,"repoUrl":26,"updatedAt":291},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[372,373,374],{"name":285,"slug":286,"type":15},{"name":288,"slug":289,"type":15},{"name":17,"slug":18,"type":15},{"slug":293,"name":293,"fn":294,"description":295,"org":376,"tags":377,"stars":25,"repoUrl":26,"updatedAt":308},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[378,379,380,381],{"name":299,"slug":300,"type":15},{"name":302,"slug":303,"type":15},{"name":305,"slug":306,"type":15},{"name":17,"slug":18,"type":15},{"slug":310,"name":310,"fn":311,"description":312,"org":383,"tags":384,"stars":25,"repoUrl":26,"updatedAt":323},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[385,386,387,388],{"name":316,"slug":317,"type":15},{"name":249,"slug":250,"type":15},{"name":320,"slug":321,"type":15},{"name":17,"slug":18,"type":15},{"slug":174,"name":174,"fn":325,"description":326,"org":390,"tags":391,"stars":25,"repoUrl":26,"updatedAt":336},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[392,393,394],{"name":330,"slug":331,"type":15},{"name":333,"slug":334,"type":15},{"name":17,"slug":18,"type":15},{"slug":338,"name":338,"fn":339,"description":340,"org":396,"tags":397,"stars":25,"repoUrl":26,"updatedAt":351},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[398,399,400,401],{"name":316,"slug":317,"type":15},{"name":345,"slug":346,"type":15},{"name":348,"slug":349,"type":15},{"name":17,"slug":18,"type":15},{"slug":4,"name":4,"fn":5,"description":6,"org":403,"tags":404,"stars":25,"repoUrl":26,"updatedAt":27},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[405,406,407,408],{"name":23,"slug":24,"type":15},{"name":20,"slug":21,"type":15},{"name":13,"slug":14,"type":15},{"name":17,"slug":18,"type":15},{"slug":410,"name":410,"fn":411,"description":412,"org":413,"tags":414,"stars":25,"repoUrl":26,"updatedAt":418},"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},[415,417],{"name":416,"slug":32,"type":15},"CLI",{"name":17,"slug":18,"type":15},"2026-04-06T18:02:57.150231",{"slug":420,"name":420,"fn":421,"description":422,"org":423,"tags":424,"stars":25,"repoUrl":26,"updatedAt":433},"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},[425,428,431,432],{"name":426,"slug":427,"type":15},"Content Strategy","content-strategy",{"name":429,"slug":430,"type":15},"Data Cleaning","data-cleaning",{"name":348,"slug":349,"type":15},{"name":17,"slug":18,"type":15},"2026-05-06T05:40:03.966799",{"slug":435,"name":435,"fn":436,"description":437,"org":438,"tags":439,"stars":25,"repoUrl":26,"updatedAt":449},"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},[440,443,444,447],{"name":441,"slug":442,"type":15},"Animation","animation",{"name":23,"slug":24,"type":15},{"name":445,"slug":446,"type":15},"Typography","typography",{"name":448,"slug":435,"type":15},"Visual Design","2026-07-24T05:40:57.887452",{"slug":451,"name":451,"fn":452,"description":453,"org":454,"tags":455,"stars":25,"repoUrl":26,"updatedAt":464},"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},[456,459,460,463],{"name":457,"slug":458,"type":15},"Debugging","debugging",{"name":249,"slug":250,"type":15},{"name":461,"slug":462,"type":15},"Screenshots","screenshots",{"name":448,"slug":435,"type":15},"2026-06-06T07:09:59.809812",81]