stale-detector

Scan Yuque knowledge bases for stale documents and generate maintenance reports.

Updated Jun 22, 2026
One-click install
npx skills add https://github.com/sliec/shared-files --skill stale-detector-sliec
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: stale-detector
Source: https://github.com/sliec/shared-files/tree/main/skills/stale-detector
Command: npx skills add https://github.com/sliec/shared-files --skill stale-detector-sliec

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Knowledge bases accumulate outdated documents over time, making it hard to know which pages need updating, archiving, or are still valid. This Skill automates the freshness audit so you can maintain a healthy knowledge base without manually reviewing every document. ## Core Features & Use Cases - Freshness Classification: Categorizes every document as Fresh, Aging, Stale, or Dormant based on days since last update, with an overall health score. - Deep Content Analysis: Reads the oldest documents to detect time-sensitive content like outdated version numbers, expired dates, and stale links, distinguishing them from evergreen content. - Actionable Maintenance Report: Produces a structured report with update, archive, keep, and review recommendations plus follow-up actions. - Use Case: During a quarterly knowledge base review, ask the assistant to scan your Yuque team wiki and receive a report listing which documents reference outdated software versions and which completed project pages can be archived. ## Quick Start Ask the assistant to check which documents in my Yuque knowledge base are outdated and generate a maintenance report.

Frequently Asked Questions about stale-detector

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

FAQPage Schema
How do I find outdated documents in a Yuque knowledge base?

Use this Skill with the yuque-mcp server connected. It lists all documents via yuque_list_docs, classifies them by days since last update, and deep-reads the oldest ones to identify time-sensitive content needing updates.

How are stale documents classified in a knowledge base audit?

Documents are grouped into four categories: Fresh (updated within 90 days), Aging (90-180 days), Stale (180-365 days), and Dormant (over 365 days). A weighted health score out of 100 summarizes overall freshness.

What do I need to connect this Skill to Yuque?

You need the yuque-mcp MCP server configured with a personal Yuque token. The Skill relies on its yuque_list_books, yuque_list_docs, yuque_get_doc, and yuque_get_toc tools to access knowledge base metadata and content.

Does the stale document scan read every document in a large knowledge base?

No. For knowledge bases with 100 or more documents, it analyzes metadata for all of them but only deep-reads the top 10 stalest documents. This keeps the scan efficient while focusing on the highest-risk content.

Will old evergreen documents be flagged as outdated?

No. The analysis distinguishes evergreen content such as principles, methodologies, and personal reflections from time-sensitive content. Evergreen documents are recommended to keep despite their age, and archive suggestions are conservative.