A

Automattic Skills

adapt
automattic
Build a new platform adapter to extract content from an unsupported platform (Blogger, Ghost, Tumblr, etc.)
official
adapt
automattic
Build a new platform adapter to extract content from an unsupported platform (Blogger, Ghost, Tumblr, etc.)
official
add-skill
automattic
Add a new skill to the a8c-design plugin. Use when you've built a Claude Code skill and want to contribute it to the shared Automattic a8c-design plugin —…
official
calypso-react-query-migration
automattic
Use when editing or migrating Calypso Reader data-fetching code — `client/components/data/query-reader-*` components, `@automattic/data-stores` Reader hooks,…
official
calypso-react-query-migration
automattic
Use when editing or migrating Calypso Reader data-fetching code — `client/components/data/query-reader-*` components, `@automattic/data-stores` Reader hooks,…
official
calypso-security-alerts
automattic
Provide advisory guidance for scanning Automattic/wp-calypso Dependabot alerts and Dependabot remediation PRs using the public dependency security alerts…
official
code-style
automattic
PHP coding standards and WordPress patterns for ActivityPub plugin. Use when writing PHP code, creating classes, implementing WordPress hooks, or structuring…
official
code-style
automattic
PHP coding standards and WordPress patterns for ActivityPub plugin. Use when writing PHP code, creating classes, implementing WordPress hooks, or structuring…
official
compose-page-blocks
automattic
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,…
official
compose-page-blocks
automattic
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,…
official
creating-blocks
automattic
Templates and guidelines for creating new WordPress blocks from scratch — load this before generating block files
official
creating-blocks
automattic
Templates and guidelines for creating new WordPress blocks from scratch — load this before generating block files
official
creating-themes
automattic
Guidelines for creating new WordPress block themes from scratch — load this before generating theme files
official
creating-themes
automattic
Guidelines for creating new WordPress block themes from scratch — load this before generating theme files
official
dashboard-create-screen
automattic
Create a new screen in the Multi-site Dashboard with automatic route registration
official
dashboard-create-screen
automattic
Create a new screen in the Multi-site Dashboard with automatic route registration
official
design-foundations
automattic
Build a coherent design-foundation JSON from a liberated site — semantic color/typography/spacing roles with evidence trails. Consumes the partial scaffold…
official
design-foundations
automattic
Build a coherent design-foundation JSON from a liberated site — semantic color/typography/spacing roles with evidence trails. Consumes the partial scaffold…
official
design-mockups
automattic
Build and present HTML/CSS design mockups with a local preview server. Use when prototyping website designs, iterating on visual concepts, or presenting design…
official
design-qa
automattic
Visual-QA loop run after replica theme install and content import. Captures replica screenshots, applies a hard responsiveness gate at 390px AND a hard…
official
design-qa
automattic
Visual-QA loop run after replica theme install and content import. Captures replica screenshots, applies a hard responsiveness gate at 390px AND a hard…
official
design-systems
automattic
Bold aesthetic direction guidance for web design. Use when making creative decisions about typography, color, motion, spatial composition, and overall visual…
official
design-systems
automattic
Bold aesthetic direction guidance for web design. Use when making creative decisions about typography, color, motion, spatial composition, and overall visual…
official
dev
automattic
Development workflows for WordPress ActivityPub plugin including wp-env setup, testing commands, linting, and build processes. Use when setting up development…
official
dev
automattic
Development workflows for WordPress ActivityPub plugin including wp-env setup, testing commands, linting, and build processes. Use when setting up development…
official
diagnose
automattic
Debug failed or low-quality extractions by analyzing logs, probing the source site, and identifying root causes
official
diagnose
automattic
Debug failed or low-quality extractions by analyzing logs, probing the source site, and identifying root causes
official
dn-cart
automattic
View the WordPress.com shopping cart using the dn CLI. Use when the user wants to see what domains are in their cart before checkout. User mode only - not…
official
dn-check
automattic
Check domain name availability and pricing using the dn CLI. Use when the user wants to know if a domain is available, see domain pricing, or verify multiple…
official
dn-checkout
automattic
Open WordPress.com checkout in the browser using the dn CLI. Use when the user wants to complete a domain purchase after adding domains to cart. User mode only.
official
dn-configure
automattic
Set up credentials for the dn CLI tool. Use when the user needs to authenticate, switch between partner and user mode, set up API keys, or connect their…
official
dn-contacts-set
automattic
Update domain contact information (WHOIS contacts) using the dn CLI. Use when the user wants to change owner, admin, tech, or billing contacts for a domain.…
official
dn-delete
automattic
Delete a domain registration using the dn CLI. Use when the user wants to remove or cancel a domain. Shows a confirmation prompt before proceeding. Partner…
official
dn-dns-get
automattic
Retrieve DNS records for a domain using the dn CLI. Use when the user wants to view current DNS records (A, AAAA, CNAME, MX, TXT, etc.) for a domain. Partner…
official
dn-dns-set
automattic
Set a DNS record for a domain using the dn CLI. Use when the user wants to add or update DNS records (A, AAAA, CNAME, MX, TXT, etc.). Partner mode only.
official
dn-info
automattic
Get detailed information about a registered domain using the dn CLI. Use when the user wants to see domain details like expiration date, nameservers, contacts,…
official
dn-privacy
automattic
Set WHOIS privacy for a domain using the dn CLI. Use when the user wants to enable, disable, or change the privacy/redaction settings for domain WHOIS records.…
official
dn-register
automattic
Register a new domain name using the dn CLI. Use when the user wants to purchase or register a domain. In partner mode, performs direct registration with…
official
dn-renew
automattic
Renew a domain registration using the dn CLI. Use when the user wants to extend a domain's registration period. Partner mode only - user mode redirects to…
official
dn-reset
automattic
Remove stored dn CLI configuration and credentials. Use when the user wants to clear their saved credentials, start fresh, or switch between authentication…
official
dn-restore
automattic
Restore a previously deleted domain using the dn CLI. Use when the user wants to recover a domain that was deleted and is still within the redemption grace…
official
dn-suggest
automattic
Get domain name suggestions based on a search query using the dn CLI. Use when the user wants creative domain name ideas, alternative TLDs, or domain…
official
dn-transfer
automattic
Transfer a domain into the registrar using the dn CLI. Use when the user wants to transfer a domain from another registrar. Requires an EPP authorization code…
official
dn-transferlock
automattic
Set or remove the transfer lock on a domain using the dn CLI. Use when the user wants to lock or unlock a domain to prevent or allow transfers to another…
official
docspress-install
automattic
Install and configure DocsPress for a GitHub repository and its WordPress publishing target. Use when an agent must publish an existing or API-versioned…
official
editing-blocks
automattic
Guidelines for modifying existing WordPress blocks — load this before editing block files
official
editing-blocks
automattic
Guidelines for modifying existing WordPress blocks — load this before editing block files
official
editing-themes
automattic
Guidelines for modifying existing WordPress block themes — load this before editing theme files
official
editing-themes
automattic
Guidelines for modifying existing WordPress block themes — load this before editing theme files
official
federation
automattic
ActivityPub protocol specification and federation concepts. Use when working with ActivityPub activities, understanding federation mechanics, implementing…
official
fix-e2e-tests
automattic
Given a wp-calypso PR number, identify the failing E2E test(s) in that PR's CI run so they can be fixed. Use when asked to investigate or fix a failing E2E…
official
fix-e2e-tests
automattic
Given a wp-calypso PR number, identify the failing E2E test(s) in that PR's CI run so they can be fixed. Use when asked to investigate or fix a failing E2E…
official
generate-docs-from-source
automattic
Generate accurate DocsPress-compatible Markdown documentation from an existing source-code repository, including maintained API versions when required. Use…
official
generating-patterns
automattic
Guidelines and examples for generating WordPress block patterns — load this when creating patterns for themes
official
generating-patterns
automattic
Guidelines and examples for generating WordPress block patterns — load this when creating patterns for themes
official
gitattributes
automattic
Use when auditing or updating .gitattributes export-ignore coverage so dev-only files (lint configs, CI, tests, docs, build tooling) don't ship in the…
official
gitattributes
automattic
Use when auditing or updating .gitattributes export-ignore coverage so dev-only files (lint configs, CI, tests, docs, build tooling) don't ship in the…
official
help-center-ui-test
automattic
Run a browser-based UI review of the WordPress.com Help Center across multiple surfaces, looking for visual and behavioral issues. Use when asked to test the…
official
help-center-ui-test
automattic
Run a browser-based UI review of the WordPress.com Help Center across multiple surfaces, looking for visual and behavioral issues. Use when asked to test the…
official
integrations
automattic
Third-party WordPress plugin integration patterns. Use when adding new integrations, debugging compatibility with other plugins, or working with existing…
official
integrations
automattic
Third-party WordPress plugin integration patterns. Use when adding new integrations, debugging compatibility with other plugins, or working with existing…
official
match-page
automattic
Orchestrate whole-PAGE visual parity, with a replayable parity log so the work survives a reconstruct. PHASE 0 — if <outputDir>/parity-log.json exists, REPLAY…
official
match-page
automattic
Orchestrate whole-PAGE visual parity, with a replayable parity log so the work survives a reconstruct. PHASE 0 — if <outputDir>/parity-log.json exists, REPLAY…
official
match-section
automattic
Reach VISUAL parity for ONE section by guiding AI to apply the captured design data (colors, padding, margins, full-bleed, font sizes, line-heights, families,…
official
match-section
automattic
Reach VISUAL parity for ONE section by guiding AI to apply the captured design data (colors, padding, margins, full-bleed, font sizes, line-heights, families,…
official
migrate
automattic
Alias for `/liberate`. Migrate a website or an owned local directory into WordPress — point it at a URL (a live site you don't control) or at a local folder of…
official
migrate
automattic
Alias for `/liberate`. Migrate a website or an owned local directory into WordPress — point it at a URL (a live site you don't control) or at a local folder of…
official
model-local-data
automattic
Analyze an OWNED local static site's JavaScript data grids or repeated static-HTML content cards and emit a data-model.json that turns that data into real…
official
model-local-data
automattic
Analyze an OWNED local static site's JavaScript data grids or repeated static-HTML content cards and emit a data-model.json that turns that data into real…
official
pr
automattic
INVOKE THIS SKILL before creating any PR to ensure compliance with branch naming, changelog requirements, and reviewer assignment.
official
pr
automattic
INVOKE THIS SKILL before creating any PR to ensure compliance with branch naming, changelog requirements, and reviewer assignment.
official
product-jtbd-copy
automattic
Use when writing or reviewing UI copy - rewrites labels, CTAs, helpers, and placeholders through a Jobs to Be Done lens so every element reflects the user's…
official
qa
automattic
Compare extracted WXR content against the original source site page by page. Find missing text, headings, images, and links. Fix by patching the WXR or…
official
qa
automattic
Compare extracted WXR content against the original source site page by page. Find missing text, headings, images, and links. Fix by patching the WXR or…
official
radical-pipelines
automattic
Execute a software engineering task by running it through six sequential phases (Prompt → Spec → Design doc → Implementation plan → Implementation →…
official
reader-protocol-pr-review
automattic
Use when reviewing PRs that touch the Reader's multi-protocol social surfaces (`client/reader/social/`, `client/reader/atmosphere/`, `client/reader/mastodon/`,…
official
reader-protocol-pr-review
automattic
Use when reviewing PRs that touch the Reader's multi-protocol social surfaces (`client/reader/social/`, `client/reader/atmosphere/`, `client/reader/mastodon/`,…
official
rebuild-section
automattic
R4a of the design-qa escalation ladder — rebuild ONE divergent section into canonical, editable WordPress core blocks from its source HTML, screenshots, spec,…
official
rebuild-section
automattic
R4a of the design-qa escalation ladder — rebuild ONE divergent section into canonical, editable WordPress core blocks from its source HTML, screenshots, spec,…
official
release
automattic
Version management and release processes using Jetpack Changelogger. Use when creating releases, managing changelogs, bumping versions, or preparing patch…
official
release
automattic
Version management and release processes using Jetpack Changelogger. Use when creating releases, managing changelogs, bumping versions, or preparing patch…
official
replicate-theme
automattic
Parity-first carry-and-scope theme reconstruction — dispatched by `/liberate` after capture. Instead of projecting the source onto editable WordPress blocks…
official
replicate-theme
automattic
Parity-first carry-and-scope theme reconstruction — dispatched by `/liberate` after capture. Instead of projecting the source onto editable WordPress blocks…
official
replicate-with-blocks
automattic
Spec-driven, whole-site block-theme reconstruction for a liberated site. Invokes design-foundations → creating-themes → clustering → spec extraction →…
official
replicate-with-blocks
automattic
Spec-driven, whole-site block-theme reconstruction for a liberated site. Invokes design-foundations → creating-themes → clustering → spec extraction →…
official
setup
automattic
Verify that the dn CLI is installed and configured. Use when the user first installs the domain-names plugin, or when a dn command fails because the CLI is…
official
site-specification
automattic
Extract comprehensive site specifications from simple descriptions. Use when analyzing a user's theme request to determine site type, audience, tone, layout…
official
site-specification
automattic
Extract comprehensive site specifications from simple descriptions. Use when analyzing a user's theme request to determine site type, audience, tone, layout…
official
studio-cli
automattic
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…
official
test
automattic
Testing patterns for PHPUnit and Playwright E2E tests. Use when writing tests, debugging test failures, setting up test coverage, or implementing test patterns…
official
testing-js
automattic
Guidelines for checking JavaScript files for syntax errors
official
testing-js
automattic
Guidelines for checking JavaScript files for syntax errors
official
testing-php
automattic
Guidelines for running PHP linting to catch syntax errors
official
testing-php
automattic
Guidelines for running PHP linting to catch syntax errors
official
testing-wp-runtime
automattic
Guidelines for running wp-now to validate WordPress plugins and themes at runtime
official
testing-wp-runtime
automattic
Guidelines for running wp-now to validate WordPress plugins and themes at runtime
official
woocommerce-finalize
automattic
Pre-release code health and traceability audit for WooCommerce plugins. Runs after code review -- focuses on dead code, duplication, structural complexity, and…
official
woocommerce-plugin-dev
automattic
Comprehensive WooCommerce plugin development skill that enforces WordPress and WooCommerce coding standards, security best practices, and end-to-end testing…
official
woocommerce-upgrade-safety
automattic
Pre-release upgrade safety review for WooCommerce plugins. Validates database migrations, settings compatibility, payment token preservation, hook deprecation,…
official
wordpress-block-theming
automattic
WordPress Full Site Editing (FSE) theme architecture. Use when generating theme.json, block templates, template parts, patterns, and functions.php for…
official
wordpress-block-theming
automattic
WordPress Full Site Editing (FSE) theme architecture. Use when generating theme.json, block templates, template parts, patterns, and functions.php for…
official
wordpress-mockups
automattic
Build accurate WordPress/Gutenberg UI mockups using pre-extracted design tokens, icons, and components. Use when prototyping WordPress admin interfaces or Site…
official
wordpress-plugin-publish
automattic
Use this skill when publishing, submitting, reuploading, verifying, packaging, checking, demoing, or releasing WordPress.org plugins with Pressship. It covers…
official
wordpress-plugin-publish
automattic
Use this skill when publishing, submitting, reuploading, verifying, packaging, checking, demoing, or releasing WordPress.org plugins with Pressship. It covers…
official
wordpress-router
automattic
Use when the user asks about WordPress codebases (plugins, themes, block themes, Gutenberg blocks, WP core checkouts) and you need to quickly classify the repo…
official
wordpress-workspace-agent-ux-consistency-check
automattic
Review WordPress Workspace Agent, site picker, conversation history, Quick Ask, QuickLauncher, settings, and sidebar UX for consistency with the repo's plain,…
official
wordpress-workspace-agent-ux-consistency-check
automattic
Review WordPress Workspace Agent, site picker, conversation history, Quick Ask, QuickLauncher, settings, and sidebar UX for consistency with the repo's plain,…
official
wordpress-workspace-doc-consistency-check
automattic
Review WordPress Workspace README, PRD, release notes, public copy, and product documentation for consistency with this repo and the current WordPress…
official
wordpress-workspace-doc-consistency-check
automattic
Review WordPress Workspace README, PRD, release notes, public copy, and product documentation for consistency with this repo and the current WordPress…
official
wordpress-workspace-preview-routing-debug
automattic
Debug WordPress Workspace Agent preview, edit-mode, authentication, proxy, and URL-routing behavior across simple WordPress.com, Jetpack, and Atomic sites. Use…
official
wordpress-workspace-preview-routing-debug
automattic
Debug WordPress Workspace Agent preview, edit-mode, authentication, proxy, and URL-routing behavior across simple WordPress.com, Jetpack, and Atomic sites. Use…
official
wordpress-workspace-release-runbook
automattic
Guide WordPress Workspace build, packaging, signing, notarization, OAuth secret injection, release checks, and release documentation for this repo. Use when…
official
wordpress-workspace-release-runbook
automattic
Guide WordPress Workspace build, packaging, signing, notarization, OAuth secret injection, release checks, and release documentation for this repo. Use when…
official
wordpress-workspace-transcription-smoke-test
automattic
Run or explain WordPress Workspace transcription endpoint smoke tests using the no-dependency shell script, bearer tokens, site IDs/domains, audio files,…
official
wordpress-workspace-transcription-smoke-test
automattic
Run or explain WordPress Workspace transcription endpoint smoke tests using the no-dependency shell script, bearer tokens, site IDs/domains, audio files,…
official
wp-abilities-api
automattic
Use when working with the WordPress Abilities API (wp_register_ability, wp_register_ability_category, /wp-json/wp-abilities/v1/*, @wordpress/abilities)…
official
wp-block-development
automattic
Use when developing WordPress (Gutenberg) blocks: block.json metadata, register_block_type(_from_metadata), attributes/serialization, supports, dynamic…
official
wp-block-themes
automattic
Use when developing WordPress block themes: theme.json (global settings/styles), templates and template parts, patterns, style variations, and Site Editor…
official
wp-interactivity-api
automattic
Use when building or debugging WordPress Interactivity API features (data-wp-* directives, @wordpress/interactivity store/state/actions, block viewScriptModule…
official
wp-performance
automattic
Use when investigating or improving WordPress performance (backend-only agent): profiling and measurement (WP-CLI profile/doctor, Server-Timing, Query Monitor…
official
wp-phpstan
automattic
Use when configuring, running, or fixing PHPStan static analysis in WordPress projects (plugins/themes/sites): phpstan.neon setup, baselines,…
official
wp-playground
automattic
Use for WordPress Playground workflows: fast disposable WP instances in the browser or locally via @wp-playground/cli (server, run-blueprint, build-snapshot),…
official
wp-plugin-development
automattic
Use when developing WordPress plugins: architecture and hooks, activation/deactivation/uninstall, admin UI and Settings API, data storage, cron/tasks, security…
official
wp-project-triage
automattic
Use when you need a deterministic inspection of a WordPress repository (plugin/theme/block theme/WP core/Gutenberg/full site) including tooling/tests/version…
official
wp-rest-api
automattic
Use when building, extending, or debugging WordPress REST API endpoints/routes: register_rest_route, WP_REST_Controller/controller classes, schema/argument…
official
wp-wpcli-and-ops
automattic
Use when working with WP-CLI (wp) for WordPress operations: safe search-replace, db export/import, plugin/theme/user/content management, cron, cache flushing,…
official
wpds
automattic
Use when building UIs leveraging the WordPress Design System (WPDS) and its components, tokens, patterns, etc.
official