oma-docs

Check documentation references against the codebase for broken links and outdated commands.

1|Updated Mar 21, 2026
One-click install
npx skills add https://github.com/first-fluke/mapple --skill oma-docs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: oma-docs
Source: https://github.com/first-fluke/mapple/tree/main/.agents/skills/oma-docs
Command: npx skills add https://github.com/first-fluke/mapple --skill oma-docs

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill verifies if documentation references are consistent with the current codebase and suggests updates for affected files, preventing outdated or broken docs.

Core Features & Use Cases

  • Documentation Verification: Detects broken links, outdated CLI commands, and incorrect references in markdown documentation files.
  • Automated Drift Detection: Compares current docs against recent code changes to identify parts needing updates.
  • Use Case: After a major refactor, verify that all documentation links and commands are up-to-date before release.

Quick Start

Use the oma-docs skill to verify documentation references in the main documentation directory.

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 a major codebase refactor?

To detect documentation drift, the Skill compares current markdown documentation against the codebase to identify broken links, outdated CLI commands, and incorrect references, then suggests updates for affected files.

How do I find broken links and outdated CLI commands in my markdown documentation?

Finding broken links and outdated CLI commands in markdown documentation involves checking references against the current codebase. The Skill automates this verification, providing updates for affected files to ensure consistency.

What is documentation drift detection and when do I need to verify references?

Documentation drift detection is the process of comparing docs against recent code changes to find inconsistencies. You need to verify references after major refactors to ensure links and commands are up-to-date before release.

Can I verify documentation references against the codebase without writing custom scripts?

You can verify documentation references without custom scripts by using this Skill to check your main documentation directory. It automates the comparison of markdown files against the codebase to locate broken links and outdated commands.

What's the best way to ensure documentation accuracy before a project release?

The best way to ensure documentation accuracy before release is to run automated drift detection. This verifies that all documentation links and commands match the current codebase, providing necessary updates for maintained consistency.