docs-librarian

Organize and deduplicate .documents repository files while maintaining a central index.

Updated Jan 26, 2026
One-click install
npx skills add https://github.com/hoonzinope/skills --skill docs-librarian
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: docs-librarian
Source: https://github.com/hoonzinope/skills/tree/main/docs-librarian
Command: npx skills add https://github.com/hoonzinope/skills --skill docs-librarian

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

The Docs Librarian tackles duplication, fragmented references, and navigational drift within the .documents workspace by consolidating related items and maintaining a central index for quick discovery and governance.

Core Features & Use Cases

  • Deduplicate and consolidate similar documents to reduce confusion.
  • Link related documents and annotate status to improve traceability.
  • Generate and maintain the central index at .documents/_ops/DOCS_INDEX.md for quick discovery and governance.

Quick Start

Organize your .documents by removing duplicates, linking related documents, and updating .documents/_ops/DOCS_INDEX.md.

Frequently Asked Questions about docs-librarian

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

FAQPage Schema
How do I organize and de-duplicate a documents repository to improve traceability?

Organizing a documents repository involves consolidating duplicate items, linking related files, and updating a central index to maintain traceability and governance. This Skill automates that process within the .documents directory to ensure consistent references and navigational stability.

What is the best way to maintain a central index for documentation-heavy workflows?

Maintaining a central index requires generating and updating a canonical source of truth, such as a DOCS_INDEX.md file. This Skill updates the index within the .documents/_ops/ directory so teams can quickly discover documentation and monitor status changes across the workspace.

How do I remove duplicate documents and link related files in a project workspace?

Removing duplicate documents and linking related files is handled by consolidating similar items and annotating their status. This Skill applies guardrails that require all writes to occur under the .documents/ path, ensuring clean navigation and reducing fragmented references.

Can I use a script to scaffold new documents within the .documents directory?

Yes, you can use script-based scaffolding to create new documents within the .documents directory. This Skill includes a scaffold_doc.py script that generates the required file structure, helping you maintain organizational governance and consistency from the start.

Does this documentation governance approach work without external dependencies?

Yes, this documentation governance approach works without external dependencies. The Skill operates independently using built-in scripts, references, and assets to manage the .documents repository, requiring only a compatible workspace structure to enforce its guardrails and index updates.

Why does my documentation index drift and become outdated over time?

Documentation index drift happens when files are added or modified without updating the central reference. This Skill prevents navigational drift by continuously consolidating related items and refreshing the .documents/_ops/DOCS_INDEX.md file to keep the workspace status current.