NEWOur agents now make the SEO fixes on your site and check what worked →

Content Refresh Skill for Decaying Pages

Your agent finds the pages that are losing clicks, rules out seasonality, and writes a specific refresh brief for each one.

  • 90-day decay from your own data
  • Seasonal dips removed
  • A specific brief per page
Start Trial
SEOmatic astronaut loading a skill cartridge into a brick robot agent
SEOmatic logo
Content Refresh skill

Skill

seomatic-content-refresh v1.0.0

Needs

SEOmatic's MCP server (free account)

Works In

Claude Code, Claude, Cursor, Codex, Gemini CLI, OpenClaw, Hermes Agent, Grok Bot and any agent that reads Agent Skills

Source

SKILL.md on GitHub, MIT license

Last Checked

October 2026

Inside the Content Refresh Skill

The Short Answer

The SEOmatic content refresh skill teaches an AI agent to find pages that lost at least a quarter of their Search Console clicks over 90 days but still have impressions, remove the ones that dip every year, and work out what slipped: queries that lost position and new queries the page barely answers. It compares the page with today's results and writes a refresh brief. SEOmatic can stage the refresh in your CMS, and in Approval mode nothing goes live until you click approve.

What You Get

A refresh brief per page: what lost, with queries, positions and dates; what to add; what to update; what to cut; and the expected outcome as a range. Pages with nothing worth saving are named too.

Ask Your Agent

Once the skill is installed, ask in your own words. For example:

  • "Which of my posts should I update?"
  • "Find my decaying content and tell me what each page needs."
  • "Make a content refresh plan for this quarter."

How the Skill Works

  1. Find the decay
  2. Find what slipped
  3. Compare with what ranks now
  4. The refresh brief

Every number comes from a tool result with its exact date range. The skill never estimates a figure it could read.

Tools It Uses

ToolWhat it reads or doesCost
gsc_performanceSearch Console PerformanceFree
gsc_insightsSearch Console InsightsFree
serp_competitorsSERP & CompetitorsFree questions or AI credits
site_pagesSite & Page AnalysisFree
keyword_researchKeyword ResearchFree questions or AI credits
task_manageSEO TasksFree to stage; paid plan, your approval

All from SEOmatic's MCP server. Parameters and full cost rules: MCP tool reference.

Install the Skill

One command installs it in Claude Code, Cursor, Codex, Gemini CLI, OpenCode and other agents that read Agent Skills. Then connect SEOmatic's MCP server at https://app.seomatic.ai/api/mcp and sign in (free, no card). In Claude on the web or desktop, open Plugins in the sidebar (called Customize before November 2026), add a skill and upload the folder as a zip; "Code execution and file creation" must be on in Settings, Capabilities. On Claude Team and Enterprise, an Owner must turn Skills on in Organization settings, Library, Policy: from 30 November 2026, plugins stop working in Claude Desktop for organizations with Skills turned off. Setup for every agent: AI assistants.

Install
npx skills add Minh42/seomatic-mcp --full-depth --skill seomatic-content-refresh

Nothing Goes Live Without You

Every fix follows your approval mode: in Approval mode, nothing changes on your site until you approve it. A fix is staged as a proposal that says what will change and why. Approved fixes run within seconds, the page's previous state is stored, and any edit to an existing page can be rolled back. A rollback refuses to overwrite edits someone made since. Changes that could take a page out of Google, like a noindex, need an extra confirmation.

Run It on a Schedule

This skill is part of the Content Planner Grok Bot template, which run it on a schedule and only speak when something changed. All templates: SEO skills and templates.

More SEO Skills

Frequently Asked Questions

Why refresh instead of writing new pages?

A page that already ranked has links, history and proof it can rank. Bringing it up to date is usually faster than ranking a new page from zero.

Does it change pages that are still growing?

No. The skill only works on pages that lost clicks, and only after ruling out a seasonal dip.

Is the Content Refresh skill free?

The skill is free and open source (MIT). Connecting is free with no card. Search Console reports, page checks and 30-page site audits are free, as often as you like. Live market data (keyword volumes, competitors, backlinks) uses free questions: 5 a month, plus a one-time 5 the first time you sign in from an assistant, and 10 more when you connect Search Console, and one question covers up to 5 lookups. Staging and publishing fixes is part of paid plans, which start with a 14-Day Trial for $1, credited to your first payment.

Which AI agents can use it?

Any agent that reads Agent Skills (SKILL.md): Claude Code, Claude on the web and desktop, Cursor, Codex, Gemini CLI, OpenCode, Kiro, OpenClaw, Hermes Agent, Grok Bot and more. It installs with one command: npx skills add.

Do I need SEOmatic's MCP server?

Yes. The skill tells your agent how to do the job; SEOmatic's MCP server gives it your real data and the tools. Connecting is free: add https://app.seomatic.ai/api/mcp to your agent and sign in.

Try It on Your Own Site First

See what your agent would fix before you install anything. We ask AI search the questions your buyers ask, then show where you show up, who shows up instead, and what to fix first.

Free. No signup. Takes about a minute.

digi-business-uk

Each local area page used to take us half a day to create and optimize.


With SEOmatic, we can create hundreds of pages in the same time, which helps our clients make the best use of their budget.


It's transformed how we deliver scalable SEO solutions.

will-hawkins

Will Hawkins

Marketing Director, Digi-Business UK

Give Your Site an SEO Team

Agents read your Search Console data, do the work, and prove what actually moved. You decide what ships.

  • You decide what ships
  • Verified live
  • One-click rollback

14-Day Trial for $1, credited to your first payment.