oma-docs

Detect broken links, outdated references, and drift in markdown documentation.

5|3|Updated Mar 11, 2026
One-click install
npx skills add https://github.com/ddarkr/antigravity-token-monitor --skill oma-docs-ddarkr
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: oma-docs
Source: https://github.com/ddarkr/antigravity-token-monitor/tree/main/.agents/skills/oma-docs
Command: npx skills add https://github.com/ddarkr/antigravity-token-monitor --skill oma-docs-ddarkr

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps verify the accuracy and currency of project documentation by detecting broken links, outdated references, and drift from code changes, ensuring maintainers keep docs aligned with the actual codebase.

Core Features & Use Cases

  • Documentation Drift Detection: Checks if documentation references match the current code structure, linking to broken files or commands.
  • Propose Updates: Generates patch suggestions for outdated docs after code modifications.
  • Use Case: After refactoring code, run oma-docs to identify obsolete or broken links and automatically suggest corrections, streamlining documentation maintenance.

Quick Start

Ask it to verify if your documentation references are up-to-date and suggest patches for any broken links or outdated sections.

Frequently Asked Questions about oma-docs

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

FAQPage Schema
How do I detect documentation drift after refactoring code?

To check for outdated documentation references, scan your project to verify that markdown links and paths match the current codebase. The tool identifies broken file references and generates patch suggestions to correct them.

How do I automate finding and fixing broken links in markdown documentation?

Automating broken link detection involves scanning your markdown documentation to locate invalid paths and outdated references. The tool then proposes automated patch suggestions to update the links and synchronize the documentation with the evolving codebase.

What is documentation drift and when do I need to validate markdown references?

Documentation drift occurs when markdown references become outdated due to codebase changes. You need to validate references after refactoring to ensure links point to valid files and commands, keeping software project docs synchronized with the actual code.

Can I use automated validation for software projects with extensive markdown documentation?

Yes, this validation applies to software projects with extensive markdown-based documentation. It checks for broken links and outdated references, applying regular validation to ensure docs remain synchronized with evolving configuration and code.

Does documentation validation work without external dependencies?

Yes, the validation operates without external dependencies. It internally checks markdown references against the current codebase structure to locate broken links and generates proposals for automation and patch updates.

What are the limitations of automated documentation validation?

A limitation is that automated validation primarily targets markdown-based documentation and relies on matching references to the current code structure. It may not fully cover non-markdown formats or complex semantic drift beyond broken links and file paths.