freshness-watch

Detect stale workspace artifacts and missed maintenance cycles in agent workspaces.

Updated Jun 23, 2026
One-click install
npx skills add https://github.com/Walliiee/agent-harness --skill freshness-watch
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: freshness-watch
Source: https://github.com/Walliiee/agent-harness/tree/main/skills/freshness-watch
Command: npx skills add https://github.com/Walliiee/agent-harness --skill freshness-watch

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill finds workspace hygiene problems that quietly build up over time, such as files that were not rotated, handoffs that were never written, or archived records that have gone stale.

Core Features & Use Cases

  • Weekly freshness audit: Checks configured workspaces for overdue daily files, missing handoffs, and stale skill-run archives.
  • Drift detection for maintenance jobs: Surfaces evidence that rotation or archival automation stopped firing as expected.
  • Operational reporting: Emits results to stdout for launchd logging and can raise a drift incident when hard violations are found.
  • Use case: A team running multiple agent workspaces can automatically verify every Sunday that routine maintenance still happened and that nothing important silently fell behind.

Quick Start

Ask the agent to run the freshness-watch audit for the configured workspaces and report any stale files, missing handoffs, or archive gaps in plain language.

Frequently Asked Questions about freshness-watch

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I detect stale files and workspace drift in agent workspaces?

Workspace drift detection identifies files that were not rotated, handoffs that were never written, and archived records that have gone stale by auditing workspaces against configured freshness thresholds and surfacing hard violations as drift incidents.

What is a freshness audit and when do I need one for workspace hygiene?

A freshness audit is a weekly operational check that scans configured repos, handoff files, and archived skill-run records to verify routine maintenance cycles still fire and that nothing important has silently fallen behind.

How do I automate a weekly freshness audit for multiple agent workspaces?

Automate weekly freshness audits by scheduling the task to run every Sunday across configured workspaces, checking for overdue daily files, missing handoffs, and stale archives, emitting results to stdout for launchd logging.

Can freshness-watch raise a drift incident when maintenance jobs stop firing?

Yes, the audit can raise a drift incident when hard violations are found, surfacing evidence that rotation or archival automation stopped firing as expected during the operational check.

Does freshness-watch require workspace mapping awareness and configured thresholds?

Yes, the audit requires workspace mapping awareness and configured freshness thresholds to accurately detect overdue daily files, missing handoffs, and stale skill-run archives across targeted repositories.