prune-knowledge

Archive stale and superseded solution documentation with YAML frontmatter analysis.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/lenlla/one_shot_build --skill prune-knowledge
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: prune-knowledge
Source: https://github.com/lenlla/one_shot_build/tree/main/skills/prune-knowledge
Command: npx skills add https://github.com/lenlla/one_shot_build --skill prune-knowledge

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Review and clean up solution documentation to remove staleness, contradictions, superseded content, and duplicates across project and team knowledge stores while preserving history by archiving rather than deleting.

Core Features & Use Cases

  • Scan project-level and configured team-level solution doc directories and extract YAML frontmatter for analysis.
  • Auto-archive docs marked as superseded and move them into a category-specific _archived folder.
  • Flag potentially stale documents based on configurable last_validated thresholds, detect version incompatibilities against project tool constraints, and surface duplicate solution candidates for merge or supersession.
  • Produce a pruning summary and stage git commits to record archival, deprecation, and refresh actions; ideal for quarterly cleanup or onboarding a new project.

Quick Start

Run the prune-knowledge skill to scan project and shared solution docs, archive superseded items, flag stale or incompatible entries, detect duplicates, and stage commits for human review.

Frequently Asked Questions about prune-knowledge

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

FAQPage Schema
How do I archive stale and superseded solution documentation in a git repository?

To archive stale and superseded solution documentation, this skill scans project and team knowledge stores, extracts YAML frontmatter, and moves outdated files to a category-specific _archived folder. It preserves history by archiving rather than deleting, then stages git commits for human review.

What is the best way to detect duplicate solution docs across project and team knowledge bases?

Detecting duplicate solution docs across project and team knowledge bases is handled by scanning configured directories and comparing YAML frontmatter metadata. The skill flags duplicate candidates for merge or supersession, generating a summary report of potential redundancies for review.

How do I flag outdated documentation based on last_validated dates and version constraints?

Flagging outdated documentation based on last_validated dates and version constraints involves comparing extracted YAML frontmatter against configurable thresholds and project tool constraints. The skill identifies incompatible entries and produces a pruning summary detailing deprecated or stale files.

Can I automate quarterly knowledge base cleanup and stage the changes as git commits?

Automating quarterly knowledge base cleanup and staging changes as git commits is supported during periodic maintenance or project onboarding. The skill archives superseded items, flags stale entries, detects duplicates, and stages git commits to record archival, deprecation, and refresh actions for review.

Do I need YAML frontmatter in my solution docs to perform knowledge base pruning?

YAML frontmatter in solution docs is required to perform knowledge base pruning, as the skill extracts these metadata fields to compare last_validated dates and version constraints. Without frontmatter, staleness detection and version incompatibility checks cannot be executed.

When should I run a documentation pruning workflow on my shared knowledge path?

You should run a documentation pruning workflow on your shared knowledge path during periodic maintenance, quarterly cleanups, or project onboarding. This ensures solution docs remain current, organized, and free of contradictions or superseded content across both project and team stores.