librarian-agent

Audit markdown wikis for broken links, missing frontmatter, and orphan pages.

Updated May 24, 2026
One-click install
npx skills add https://github.com/angrysky56/hermes-ops --skill librarian-agent
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: librarian-agent
Source: https://github.com/angrysky56/hermes-ops/tree/main/skills/librarian-agent
Command: npx skills add https://github.com/angrysky56/hermes-ops --skill librarian-agent

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill eliminates the tedious, error-prone manual work of maintaining a large knowledge wiki, handling structural quality checks and content fixes automatically so you can focus on adding high-value content instead of cleaning up metadata and broken links.

Core Features & Use Cases

  • Automated Structural Audits: Runs full wiki health checks including broken wikilink detection, orphan page identification, missing frontmatter validation, tag consistency normalization, and HITS authority/hub scoring for knowledge graph health.
  • Iterative Content Remediation: Delegates fix work to a specialized subagent to resolve broken links, add missing inbound links, fill frontmatter gaps, and normalize tags in small, controlled batches to avoid overwhelming the wiki.
  • Cron-Job Resilient Execution: Includes built-in fallback logic for when MCP tools are unavailable in scheduled environments, using filesystem audit scripts to ensure maintenance runs complete successfully even if the knowledge graph server is offline.
  • Use Case: Perfect for teams maintaining large Obsidian-based knowledge wikis or Zettelkasten vaults that need regular, automated quality checks without dedicating manual hours to cleanup tasks.

Quick Start

Use the librarian-agent skill to run a full structural audit of your wiki at /home/ty/Documents/LLM-WIKI and automatically fix all broken links, missing frontmatter, and orphan pages.

Frequently Asked Questions about librarian-agent

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

FAQPage Schema
How do I automate broken link repair and frontmatter validation in a large markdown wiki?

You can automate broken link repair and frontmatter validation by running scheduled structural audits that detect missing metadata, identify orphan pages, and iteratively fix cross-references in controlled batches without manual cleanup.

What is the best way to normalize tags and identify orphan pages in an Obsidian vault?

The best way to normalize tags and identify orphan pages in an Obsidian vault is to perform an automated structural audit that checks tag consistency against canonical taxonomies and maps inbound wikilinks to isolate unlinked notes.

Can I run cron-scheduled Zettelkasten audits if my knowledge graph MCP server is offline?

Yes, you can run cron-scheduled Zettelkasten audits when your knowledge graph MCP server is offline because the audit includes built-in fallback logic that uses filesystem scripts to ensure maintenance runs complete successfully.

How does a subagent handle content remediation for missing frontmatter in a knowledge wiki?

A subagent handles content remediation for missing frontmatter by receiving delegated fix tasks, resolving metadata gaps against canonical schemas, and applying changes in small iterative batches to avoid overwhelming the wiki structure.

Does automated wiki maintenance work with Neo4j-backed knowledge graphs?

Automated wiki maintenance works with Neo4j-backed knowledge graphs by applying HITS authority and hub scoring to evaluate knowledge graph health and remediating structural inconsistencies across cross-references and metadata.