pruning-stale-and-nonfunctional-material

Classify and safely remove stale, duplicate, or dead repository material while preserving evidence and compatibility.

Updated Jul 9, 2026
One-click install
npx skills add https://github.com/alsdmlals4-eng/Base --skill pruning-stale-and-nonfunctional-material-alsdmlals4-eng
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: pruning-stale-and-nonfunctional-material
Source: https://github.com/alsdmlals4-eng/Base/tree/main/skills/pruning-stale-and-nonfunctional-material
Command: npx skills add https://github.com/alsdmlals4-eng/Base --skill pruning-stale-and-nonfunctional-material-alsdmlals4-eng

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Repositories accumulate stale files, duplicate content, dead paths, and unreachable documents that add noise without changing behavior. This Skill provides a disciplined workflow to reduce that bulk without losing unique functionality, evidence, or backward compatibility. ## Core Features & Use Cases - Structured Decision Workflow: Follows an inventory → classify → preserve-unique → prune-approved → verify-no-loss pipeline with explicit KEEP, MERGE, MOVE_TO_REFERENCE, COMPATIBILITY_STUB, ARCHIVE, DELETE, and UNVERIFIED verdicts. - Decision Matrix Reference: Ships a references/pruning-decision-matrix.md file defining each verdict and the pre-deletion checks (canonical sources, back-references, generators, CI, external links). - Safety Gates: Blocks deletion when usage, consumers, or authority are unverified, and requires re-verification of canonical freshness, links, registry, and tests after pruning. - Use Case: When cleaning up a documentation repository before a release, use this Skill to classify every candidate file, preserve unique evidence, and produce an auditable report of what was removed and why. ## Quick Start Ask the AI to audit this repository for stale, duplicate, or unreachable files and produce a KEEP/MERGE/ARCHIVE/DELETE classification with rollback notes.

Frequently Asked Questions about pruning-stale-and-nonfunctional-material

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

FAQPage Schema
How do I safely delete unused files from a repository?

Inventory candidates first, then classify each as KEEP, MERGE, MOVE_TO_REFERENCE, COMPATIBILITY_STUB, ARCHIVE, DELETE, or UNVERIFIED. Before deleting, verify canonical sources, back-references, generators, CI, and external links, and keep a rollback path.

How to decide between archiving and deleting old documentation?

Archive when audit, legal, or approval history still matters but the content is no longer an active input. Delete only when there is no unique functionality, consumer, evidence, or compatibility value and the removal is reversible.

When should I not prune repository files?

Do not prune when usage, consumers, or authority cannot be verified, when deletion requires user approval or a repository contract, or when the material holds unique evidence or compatibility value. Mark these UNVERIFIED instead.

What is a compatibility stub in repository cleanup?

A compatibility stub is a minimal placeholder kept at an old path when external consumers still reference it. It preserves routing and links while the real content moves to a new canonical location.

Why is deleting files just because they look unused risky?

Absence of visible usage does not prove a file is dead; it may be generated, referenced by CI, linked externally, or required for compatibility. The Skill treats usage-only deletion as a quality-gate failure.