secondbrain-freshness

Analyze creation and modification dates to classify SecondBrain entities as Critical, Stale, or Warning.

15|Updated Dec 21, 2025
One-click install
npx skills add https://github.com/sergio-bershadsky/ai --skill secondbrain-freshness
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: secondbrain-freshness
Source: https://github.com/sergio-bershadsky/ai/tree/main/plugins/secondbrain/skills/secondbrain-freshness
Command: npx skills add https://github.com/sergio-bershadsky/ai --skill secondbrain-freshness

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps teams quickly identify aging or attention-needed content across a SecondBrain workspace by evaluating configured freshness thresholds and timestamps.

Core Features & Use Cases

  • Analyze enabled entities (ADRs, Tasks, Notes, Discussions) to determine freshness based on last-modified or created dates.
  • Classify items into Critical, Stale, and Warning with suggested remediation actions and a consolidated report.
  • Update the last_freshness_check timestamp in the project config and provide an exportable summary.

Quick Start

Run a freshness check to generate the latest report.

Frequently Asked Questions about secondbrain-freshness

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

FAQPage Schema
How do I check data freshness across SecondBrain entities?

Check data freshness by computing creation and modification dates for ADRs, Tasks, Notes, and Discussions, then applying per-entity thresholds to classify items into Critical, Stale, or Warning for targeted remediation.

What is data aging remediation and when do I need it?

Data aging remediation is the process of identifying outdated workspace content that exceeds configured freshness thresholds. You need it when stale ADRs, Tasks, Notes, or Discussions require targeted updates to maintain accuracy.

Can I customize freshness thresholds for different entity types?

Yes, you can apply per-entity freshness thresholds to classify ADRs, Tasks, Notes, and Discussions individually into Critical, Stale, or Warning categories based on their specific aging limits.

How do I generate a stale content report for my workspace?

Generate a stale content report by running a freshness check that analyzes modification dates across enabled entities, classifies findings, and outputs a structured report with actionable remediation insights.

What's the best way to identify outdated ADRs and Notes?

Identify outdated ADRs and Notes by computing their freshness against configured thresholds, which evaluates creation and modification dates to flag items needing critical attention or warnings.

Does the freshness check update the last checked timestamp automatically?

The freshness check optionally updates the last_freshness_check timestamp in the project configuration after analyzing all enabled entities and generating the structured remediation report.