Guide · Agent skill
How to use the Content Freshness Signals agent skill (freshness)
Updated · written with AI from the project's own documentation and checked against our catalogue data
The freshness skill is a set of instructions that lets an AI agent review your article and blog pages for signals showing when content was last updated. It covers the Last-Modified HTTP header, the dateModified field in Article structured data (JSON-LD), and a visible 'Last updated' date. This guide explains what the skill does, how to install it, how to ask for it with natural requests, and what to check before relying on it.
Quick start
- 1Download the ZIP. Get the freshness skill ZIP from the directory page.
- 2Unzip into a skills folder. Unzip into ~/.claude/skills/ for personal use or .claude/skills/ inside a project.
- 3Or upload in the Claude apps. Go to Settings → Capabilities → Skills and upload the skill.
- 4Ask for an audit. Describe the page or template you want checked in plain language.
- 5Review the findings. Compare the Last-Modified header, JSON-LD dateModified and visible date for each page.
- 6Apply fixes. Make the suggested server or CMS changes, then recheck the headers and markup.
What the freshness skill makes the agent do
Agent skills are folders of instructions that an AI agent loads when a task matches the skill's description. The freshness skill is written for auditing content pages for freshness signals, setting up Last-Modified headers in a web server config, and making sure Article JSON-LD dateModified is updated when CMS content changes.
When installed, the agent can check each article or blog page for: the Last-Modified HTTP response header, a dateModified property in ISO 8601 format, a visible 'Last updated' date, and whether these three agree. It can flag mismatches, suggest web server or CMS changes, and explain why freshness matters for time-sensitive content.
Install the freshness skill
Download the ZIP for the skill from the directory page and unzip it. Place the folder in one of these locations: ~/.claude/skills/ for your personal use, or .claude/skills/ inside a project for that project only.
You can also upload the skill in the Claude apps under Settings → Capabilities → Skills.
- Personal: unzip into ~/.claude/skills/
- Project: unzip into .claude/skills/ in your project folder
- Claude apps: Settings → Capabilities → Skills, then upload
Trigger the skill with natural requests
You do not need a special command. Describe the task in plain language and the agent will load the skill when the request matches its description. The skill is a good fit for requests about auditing freshness, Last-Modified headers, or dateModified in article templates.
- Audit this article page for freshness signals.
- Check whether the Last-Modified header is set on our blog pages.
- Our CMS updates dateModified on every save. Review how to limit that to real content changes.
- Add a visible 'Last updated' date to this article template and make sure it matches dateModified.
Work through a typical audit
For each article, the skill's checklist asks four questions: is the Last-Modified header present and recent, is dateModified in the JSON-LD in ISO 8601 format, is a visible 'Last updated' date shown to readers, and do the JSON-LD date, the visible date and the header agree.
The skill's fix guidance includes configuring Nginx with add_header Last-Modified $date_gmt; and noting that Apache serves Last-Modified automatically for static files when mod_headers is enabled. It also covers passing a frontmatter updatedAt field through to JSON-LD and <time> elements in static site generators such as Next.js or Astro.
- Keep dateModified tied to substantive content changes, not metadata-only saves.
- Do not run a blanket timestamp update on every page during deploy.
{ "@type": "Article", "dateModified": "2024-11-20T14:30:00Z" }Limits and safety notes
The skill is advice and checklist work. It does not change your rankings and cannot guarantee any search gain. It only sets out the recommended signals. The source describes Google's QDF algorithm as boosting recent or updated content for time-sensitive queries; whether that applies to your site is a judgement you should make.
According to its metadata, the skill requires nothing beyond the agent itself, does not run scripts, and does not use the network. Its files are SKILL.md and references/rule.md.
- Not useful for sites without time-sensitive content.
- Expect recommendations, not guaranteed ranking results.
What people use it for
- Checking that news or tutorial pages send a Last-Modified header.
- Reviewing an article template so dateModified and the visible 'Last updated' date match.
- Advising a CMS team to update dateModified only on substantive edits.
- Setting up Last-Modified in an Nginx config using the documented add_header line.
- Passing an updatedAt frontmatter field through to JSON-LD in an Astro or Next.js site.
Frequently asked questions
How do I install the freshness agent skill?
Download the ZIP from the directory page and unzip it into ~/.claude/skills/ for personal use, or into .claude/skills/ inside a project. You can also upload it in the Claude apps under Settings → Capabilities → Skills.
Does the freshness skill need any requirements or network access?
The skill lists no requirements, does not run scripts, and does not use the network, according to its metadata. It consists of instructions the agent reads.
Is the freshness skill free and what is its licence?
The skill is licensed under the MIT licence. The source does not state any price, so check the directory page for current terms.
Will this skill improve my Google rankings?
No. The skill is advice and checklist work that sets out recommended freshness signals. It does not change rankings and cannot guarantee gains. Whether freshness helps depends on whether your content is time-sensitive.
Why isn't my Last-Modified header showing up?
The skill's guidance is to configure your web server to send it. For Nginx, use add_header Last-Modified $date_gmt; and for Apache, ensure mod_headers is enabled, since static files serve Last-Modified automatically.
How is this different from setting a published date?
Freshness signals focus on when content was last updated, using Last-Modified, dateModified and a visible 'Last updated' date. The skill checks that these agree with each other rather than only recording the original publication date.
New agent skills, repos and AI tools — every week
The best new skills and open-source projects, the fastest-growing repos, and one free prompt. Five minutes to read. Unsubscribe anytime.
Our verdict
The freshness skill suits website owners, SEO staff and front-end or CMS developers who publish time-sensitive articles and want their updates reflected in headers and structured data. It is less useful for sites without time-sensitive content, or for anyone expecting a guaranteed ranking benefit.
Download the skill