wp-variation

wp-variation is a command for coding agents from siddik-web/wp-block-theme-converter. It costs 25 tokens per session (3,106 once invoked), scanned A, original, MIT.

A command that creates a WordPress block theme style variation: a JSON file that changes the site's colors, fonts, or spacing from the base theme.

In plain words
What is it for?
Use it to create dark, light, high-contrast, seasonal, or brand-alternate versions of a WordPress block theme. It is for site-wide changes, not individual pages or blocks.
Why use it?
It avoids editing the main theme when you need a global alternative such as dark mode or a different brand palette. The same variation can apply across the whole site.

Command

Part of the wp-block-theme-converter plugin — 1 skill, 11 commands, 1 agent, 1 hook shipped together

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add commands/siddik-web/wp-block-theme-converter/wp-variation
Clone the repo
git clone --depth 1 https://github.com/siddik-web/wp-block-theme-converter

Or install wp-block-theme-converter, the plugin that ships this one along with the rest of its 1 skill, 11 commands, 1 agent, 1 hook.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for wp-variation

README.md
[![agentmods](https://agentmods.dev/badge/commands/siddik-web/wp-block-theme-converter/wp-variation.svg)](https://agentmods.dev/commands/siddik-web/wp-block-theme-converter/wp-variation)
Your own site
<a href="https://agentmods.dev/commands/siddik-web/wp-block-theme-converter/wp-variation"><img src="https://agentmods.dev/badge/commands/siddik-web/wp-block-theme-converter/wp-variation.svg" alt="Measured on agentmods" height="20"></a>
Per session 25 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 3,106 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00025 $0.03106
Opus 5 $0.00013 $0.01553
Sonnet 5 $0.00005 $0.00621
Haiku 4.5 $0.00003 $0.00311

Measured 5d ago against content hash 2f6a74e75d93, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

wp-variation scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 5d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

commands/wp-variation.md · 387 lines

How it starts

The opening of the file, as written. The whole thing — 387 lines — stays where its author put it; the contents beside it link to each section on GitHub.

/wp-variation

Purpose: Generate a WordPress block theme style variation — a styles/*.json file that overrides color, typography, and spacing from the base theme.json to create an alternative theme aesthetic.

When to Use

Trigger this command when:

  • The user wants a dark, light, high-contrast, seasonal, or brand-alternate version of their theme
  • The user says "color scheme", "variant", "skin", "dark mode", "alternate palette"
  • A design system has multiple brand expressions (e.g., marketing vs. product, seasonal themes)

Do not use this command for per-page or per-block style changes — style variations apply globally to the entire site.

Workflow

Step 1: Gather Variation Details

Ask (or infer from context):

Question Default if silent
Variation name (human-readable) Required — always ask
Variation slug (kebab-case file name) Derived from name
What to change: colors, typography, spacing, or all three? Colors only (most common)
Color palette overrides Required if colors are changing
Font overrides Optional — only if changing fonts
Spacing overrides Optional — only if changing scale
Is this a global variation (appears in Site Editor) or a scoped variation (Section Style on a Group block)? Global variation

Global vs Scoped Variations:

Global Style Variation Section Style
Applies to Entire site A single block instance
File location styles/{{slug}}.json styles.blocks.core/group.variations.{{slug}} in theme.json
Appears in Site Editor → Styles → Browse styles Block toolbar → Styles
WordPress version 6.0+ 6.6+

If the user wants a variation for a single block (e.g., a "dark section" Group block), refer to references/modern-blocks.md — Section Styles section instead.

Step 2: State the Variation Plan

VARIATION PLAN: {{Variation Name}}
File: styles/{{slug}}.json
Changes:
  Colors:     {{list color palette changes}}
  Typography: {{list font changes, or "no changes"}}
  Spacing:    {{list spacing changes, or "no changes"}}
  Elements:   {{list element style changes}}

Read the full file on GitHub · 387 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 5d ago First seen · 387 lines · 25 tokens per session scan A 2f6a74e75d93

Subscribe to this mod's changes

wp-variation is a command published in the GitHub repository siddik-web/wp-block-theme-converter (45 stars, last pushed 3mo ago), licensed MIT. It adds 25 tokens to every session and 3,106 once invoked, about $0.0001 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.