skills.rest
LadderChaos
LadderChaosCOMMUNITY
Explore all skills by this author →
GitHub

repo-librarian

Remove dead code, archive legacy artifacts, and synchronize documentation files.

Updated Aug 23, 2026
Search Tags:#architecture#documentation#markdown#cleanup#ADR#repo-management
One-click install
npx skills add https://github.com/LadderChaos/tora-skills --skill repo-librarian
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: repo-librarian
Source: https://github.com/LadderChaos/tora-skills/tree/main/repo-librarian
Command: npx skills add https://github.com/LadderChaos/tora-skills --skill repo-librarian

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill cleans repositories by removing dead code, archiving legacy artifacts, and reorganizing documentation.

Core Features & Use Cases

  • Dead code elimination: identify and remove unused functions, variables, and imports.
  • Legacy artifact removal: archive or delete files no longer part of current architecture.
  • Documentation synchronization: maintain KNOWLEDGE.md, GUIDE.md, and ADRs in sync with code.
  • Markdown reorganization: audit, reorganize, archive superseded docs, and maintain a clear index.
  • Pre-release hygiene: perform cleanup before major version releases to ensure a clean handoff.

Quick Start

Run the repo-librarian workflow on a repository with cluttered structure. Start with inventory and categorization of files, then archive superseded docs and update internal links, and finally verify imports and update CHANGELOG.

Frequently Asked Questions about repo-librarian

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

FAQPage Schema
How do I clean up dead code and legacy artifacts in a repository?▼

Documentation synchronization keeps KNOWLEDGE.md, GUIDE.md, and ADRs aligned with your codebase by auditing markdown files, archiving superseded docs, maintaining a clear index, and updating internal links.

What is the best way to reorganize scattered markdown documentation?▼

Markdown reorganization audits your scattered docs, archives superseded files, maintains a clear index, and updates internal links to ensure your repository documentation remains structured and accessible.

Can I automate repository cleanup before a major version release?▼

Yes, you can perform pre-release hygiene by running cleanup workflows to eliminate dead code, archive legacy artifacts, and reorganize documentation before major version upgrades to ensure a clean handoff.

How do I keep ADRs and markdown guides in sync with code changes?▼

Documentation synchronization maintains KNOWLEDGE.md, GUIDE.md, and ADRs in sync with code changes by applying indexing workflows and updating internal links after major architectural modifications.

Does this repository cleanup workflow require any external dependencies?▼

No external dependencies are required. The cleanup workflow operates by inventorying files, archiving superseded docs, verifying imports, and updating the CHANGELOG directly within your existing repository structure.

Related Skills

Explore More Software Engineering Skills→
Pabloprogramador23Pabloprogramador23

reversa-scout

Map legacy project folders, languages, frameworks, dependencies, and entry points.

Community
Intermediate
AhmedElhadareyAhmedElhadarey
2

eval-code-quality

Validate TypeScript/JavaScript code quality across builds, types, patterns, and tests.

Community
Advanced
coff33ninjacoff33ninja

adr-and-documentation

Manage Architecture Decision Records and synchronize documentation with codebase changes.

Community
Intermediate
mjamoremjamore

repo-docs

Synchronize repository documentation with source code using doc-first workflows.

Community
Advanced