docs-maintainer

Validate links and audit skill quality across AGENTS.md and llms.txt.

1|Updated Nov 26, 2025
One-click install
npx skills add https://github.com/niltsiar/kotlin_multiplatform_pokedex --skill docs-maintainer-niltsiar
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: docs-maintainer
Source: https://github.com/niltsiar/kotlin_multiplatform_pokedex/tree/main/.agents/docs-maintainer
Command: npx skills add https://github.com/niltsiar/kotlin_multiplatform_pokedex --skill docs-maintainer-niltsiar

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Keep project documentation healthy by validating links, consolidating duplicates, and auditing skill quality across entrypoints like AGENTS.md and llms.txt.

Core Features & Use Cases

  • Validate links across docs/ and .agents/ using the provided script to catch broken references
  • Consolidate duplicate content by referencing canonical sources instead of duplicating information
  • Audit skill quality by ensuring descriptions follow standard structure and cross-references stay up-to-date
  • Sync entrypoints (AGENTS.md, llms.txt) to maintain consistent routing and AI discovery

Quick Start

Run the docs-maintainer workflow to validate links and audit skills by executing the validate-links script.

Frequently Asked Questions about docs-maintainer

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

FAQPage Schema
How do I validate links across AGENTS.md and llms.txt documentation?

You can validate links across AGENTS.md and llms.txt by running the provided validate-links script, which scans docs/ and .agents/ directories to catch broken references and keep entrypoints in sync.

What is the best way to consolidate duplicate content in skill documentation?

The best way to consolidate duplicate content is to reference canonical sources instead of duplicating information, ensuring progressive-disclosure alignment and keeping entrypoints in sync.

How do I audit skill quality for SKILL.md references?

You audit skill quality by ensuring descriptions follow a standard structure and verifying that cross-references stay up-to-date across the documentation ecosystem using the docs-maintainer workflow.

Can I use this to sync entrypoints for AI discovery?

Yes, you can sync entrypoints like AGENTS.md and llms.txt to maintain consistent routing and AI discovery by applying canonical sourcing and progressive-disclosure alignment across the documentation ecosystem.

Why do I need canonical sourcing for documentation cross-references?

You need canonical sourcing for documentation cross-references to govern content de-duplication, ensuring that entrypoints reference a single source of truth rather than maintaining divergent duplicated information.

What are the limitations of automating link validation in docs?

A limitation of automating link validation is that while the script catches broken references, maintaining cross-reference governance and progressive-disclosure alignment still requires manual canonical sourcing decisions.