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

Ready to run

npx skills add https://github.com/LadderChaos/tora-skills --skill repo-librarian

💬 Prompt for ChatGPT / Claude Chat▼

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.