Agent Abilities
GitHubGet it free
Product
FeaturesSecurityAll abilitiesIntegrationsBridge overviewBridge plugin directory196

Guides

WordPress MCP serverAbilities API guideElementor MCP

WordPress core abilities

Browse all abilitiesContentTaxonomies & TermsCommentsUsersMediaSite settingsPluginsThemes & stylesBlocksMenusSearch

Integrations

All integrationsWooCommerce52Advanced Custom Fields7Rank Math SEO5Yoast SEO3All in One SEO3Slim SEO2The Events Calendar13Event Tickets3Avada2GeoDirectory4

Bridge, most installed

Elementor Website BuilderYoast SEOWooCommerceAkismet Anti-spamWPFormsRank Math SEOWP Mail SMTPWPCode
Connect
All clientsChatGPTClaude.aiClaude DesktopManusClaude CodeCursorVS CodeWindsurfGemini CLIGetting startedHow connecting works
Resources
Prompt LibraryPlaybooksBlogComparisonsChangelogSupport
DocsGitHubGet it free

Rewrite one paragraph or heading on a page

ContentBeginner~5 min
AbilitiesGet postReplace block

Before you start

Plugin version 1.10.0 or newer. Replace block is a write and is off until you switch it on in the Abilities tab, along with the content reads. The agent needs edit access to the page.

Sometimes the fix is one block. The intro paragraph on the pricing page reads stiffly, or a heading promises something the product no longer does. You know exactly which block you mean, you would like better words in it, and you do not want the rest of the page touched while it happens.

This prompt rewrites that one block and leaves the page around it alone.

The prompt
On our [Pricing] page (id [61]) I want to rewrite one block: the [intro
paragraph under the main heading]. Here is what it should get across:
[plans are billed yearly, every plan includes support, and you can cancel
any time].


Read the page as raw block markup, find that block, and tell me its
position, block name and current text so we know it is the right one.


Draft new wording in the same voice as the rest of the page. Keep the
block's existing attributes exactly as they are and change only the
text. Show me the old block and the new markup side by side, and do not
save until I say go. When I do, replace only that block, checking that
the block at that position is still the one we agreed on, and tell me
about any content warnings the write returns.

Why this is safe to run

The page read changes nothing, and you confirm the block and see the exact new markup before anything is saved. The write is a single Replace block call against that one block, and the plugin leaves the other blocks’ parsed attributes and HTML as they were.

Because the agent passes the block name it expects at that position, a page that changed since the read is refused instead of edited in the wrong place. Replace block is off until you enable it, it is checked against the edit access of the user you bound the agent to, and the call lands in the Activity Log. With revisions on, the page’s history can bring the old wording back.

For a bigger change, a whole section swapped for a different layout, use swap one block on a page.

Already connected? You do not have to paste this. Ask your agent for the “rewrite one paragraph or heading” recipe, or point it at the block you want reworded, and it runs the same flow on your own site.

How it works

  1. Read the page as raw block markup and find the paragraph or heading you mean.
  2. Confirm its position, block name and current text with you.
  3. Draft the new wording, keeping the block's existing attributes, such as its level, color or alignment.
  4. Show the old block and the new markup side by side and wait for your approval.
  5. Replace that one block and report any content warnings the write returns.

Questions

Why not a find-and-replace?
A find-and-replace swaps a phrase you already know. This is for when you want a block reworded, a clearer intro or a tighter heading, and the new text is longer or shaped differently than the old. The whole block is rewritten, and nothing outside it is sent.
Will the heading keep its style?
The prompt tells the agent to keep the block's existing attributes, such as heading level, color and alignment, and to change only the text. You check that in the preview before it saves.

Related recipes