oma-docs

oma-docs is a skill for Claude Code from first-fluke/oh-my-agent. It costs 83 tokens per session (5,131 once invoked), scanned C, original, MIT.

A documentation checker for software repositories. It looks through Markdown files to see whether documented paths, commands, configuration keys, scripts, and translations still match the code.

In plain words
What is it for?
Use it to verify documentation references, propose updates for files affected by a code change, detect differences between English and translated docs, and check translated docs for CJK style issues.
Why use it?
Documentation can become inaccurate after files are renamed, code is refactored, or features change; this helps find those mismatches before they confuse users or ship in a release.

Skill for Claude Code

Written for Claude Code: shipped in a Claude Code plugin. Also seen: mentions CLAUDE.md; mentions Claude Code; installed under .agents/ (shared by several agents).

Part of the oma plugin — 33 skills shipped together , and of oma

Good fit Use it to verify documentation references, propose updates for files affected by a code change, detect differences between English and translated docs, and check translated docs for CJK style issues.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/first-fluke/oh-my-agent/oma-docs
About the project

oh-my-agent is a harness for checking whether coding agents actually completed their work by verifying tests, required artifacts, independent reviews, and recorded decisions. It is used across multiple agent runtimes to make workflow results auditable instead of relying on an agent's own report. The catalogue add-ons provide parts of its skills, agents, hooks, MCP integrations, instructions, and plugins.

first-fluke/oh-my-agent · 1,273 stars · on GitHub · firstfluke.com

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add first-fluke/oh-my-agent --skill oma-docs
Clone the repo
git clone --depth 1 https://github.com/first-fluke/oh-my-agent

Made for: Claude Code.

Or install oma, the plugin that ships this one along with the rest of its 33 skills.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for oma-docs

README.md
[![agentmods](https://agentmods.dev/badge/skills/first-fluke/oh-my-agent/oma-docs.svg)](https://agentmods.dev/skills/first-fluke/oh-my-agent/oma-docs)
Your own site
<a href="https://agentmods.dev/skills/first-fluke/oh-my-agent/oma-docs"><img src="https://agentmods.dev/badge/skills/first-fluke/oh-my-agent/oma-docs.svg" alt="Measured on agentmods" height="20"></a>
Per session 83 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 5,131 The whole file, excluding the scripts and references it only reads on demand.
Security scan C 1 finding. A grade says what 26 rules found in the file — not that it is safe. Third-party audits
  • NVIDIA SkillSpector warn 7 Sept 2026
SkillSpector: 3 findings, up to high

These are SkillSpector’s own severities. On a checked sample its high-severity flags on skills were ~96% false positives — a documented command, a public API, a “never do X” rule — so we show them as a caution to read, not a verdict. Why →

  • high YARA Match · line 3
    YARA rule matched a hack tool or exploit indicator (offensive tools, reconnaissance, privilege escalation, or exploit frameworks).
    Fix: Remove offensive tool references and exploit code. Legitimate agent skills should not contain penetration testing tools, exploit frameworks, or reconnaissance utilities.
  • high Prompt Injection · line 275
    Hidden instructions were detected in comments or invisible text. These could contain malicious directives. Manual review is recommended.
    Fix: Audit all comments and invisible characters. Remove any instructions that direct the agent to perform unauthorized actions. Use plain, reviewable content.
  • high Prompt Injection · line 275
    Hidden instructions were detected in comments or invisible text. These could contain malicious directives. Manual review is recommended.
    Fix: Audit all comments and invisible characters. Remove any instructions that direct the agent to perform unauthorized actions. Use plain, reviewable content.
How audits are shown
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00083 $0.05131
Opus 5 $0.00042 $0.02566
Sonnet 5 $0.00017 $0.01026
Haiku 4.5 $0.00008 $0.00513

Measured 8d ago against content hash 9f804b96d0e4, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-07, from the pricing page.

Security

Grade C, and why

oma-docs scanned grade C with 1 finding against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 8d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Hidden instructionshighPrompt injection

Directives inside HTML comments, invisible characters or bidirectional overrides are read by the model and not by the person reviewing the file.

9. **Escape hatch respected**: `<!-- oma-docs:ignore-start -->` / `<!-- oma-docs:ignore-end -->` blocks and frontmatter `oma-docs: skip` are honored; no ref extraction from ignored regions. Use this for illustrative exam
Origin

Copies of this mod

1 near-identical copy found in the catalogue:

  • oma-docs — 100% identical, 0 lines differ
.agents/skills/oma-docs/SKILL.md · 289 lines

How it starts

The opening of the file, as written. The whole thing — 289 lines — stays where its author put it; the contents beside it link to each section on GitHub.

oma-docs - Documentation Drift Detector

Scheduling

Goal

Detect broken references in repo markdown — default glob **/*.md (verify mode), propose LLM-generated patch proposals for docs affected by recent code changes (sync mode), detect structural drift between English source docs and their translations (i18n mode), and lint translated docs for CJK style anti-patterns (lint mode). All modes run on-demand; sync is always interactive.

Intent signature

  • User asks to check if docs are up to date, find broken doc links, verify file paths referenced in docs, or detect documentation drift.
  • User asks to update docs after a code change, propose doc patches for a git diff, or sync affected docs.
  • User asks whether translations are stale, which i18n docs drifted from the English source, or to lint translated docs for style issues (em-dashes in CJK targets, etc.).
  • A workflow hook checks docs.auto_verify: true and runs oma docs verify --json at completion.

When to use

  • After a refactor, rename, or file deletion, to find stale references in docs.
  • Before a release, to confirm that CLI commands, file paths, and config keys in docs still exist.
  • After a significant git diff, to discover which docs reference the changed files and may need updating.
  • After updating English source docs (web/docs), to find translations (web/i18n/{lang}/...) that drifted or went missing.
  • Before a docs release, to lint CJK translations for content-level anti-patterns.
  • Routine drift check on any docs-heavy repo.

When NOT to use

  • Generating docs from scratch for undocumented features → v2 create mode.
  • Actually translating or restructuring docs → use oma-translation (oma docs i18n / oma docs lint only detect; they never edit translations).
  • Symbol-level semantic drift (function signature changes not reflected in prose) → v2 L3 mode.
  • CI-blocking enforcement → v2 block mode (v1 is warn-only).
  • Explaining a code change as an educational document → use oma-explanation (this skill detects drift; it does not author explainers).

Read the full file on GitHub · 289 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 8d ago First seen · 289 lines · 83 tokens per session scan C 9f804b96d0e4

Subscribe to this mod's changes

oma-docs is a skill published in the GitHub repository first-fluke/oh-my-agent (1,273 stars, last pushed yesterday), licensed MIT. It adds 83 tokens to every session and 5,131 once invoked, about $0.0004 per session on Opus 5. A static security scan graded it C with 1 finding (hidden instructions). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

agent-harness-fault-injection

Use when an agent workflow needs deterministic recovery evidence for sandbox, MCP/tool, worker, checkpoint, memory, or orchestration failures.

sickn33/agentic-awesome-skills · 34 tokens

orch

AI agent orchestrator — manage teams of AI agents that work on your codebase in parallel. Use when the user wants to: run multiple agents, coordinate AI work, deploy agent teams, manage tasks/goals/agents, check orchestrator status, or mentions 'orch', 'orchestry', 'agents team', 'agent orchestration'.

oxgeneral/ORCH · 71 tokens

pm-skills

Use when coordinating project-delivery work across the 8 project-management sub-skills — sprint/velocity analytics, portfolio health, Jira/JQL, Confluence, Atlassian admin, templates, meeting analysis, team comms. Triggers on 'our sprints feel off', 'project health report', 'audit our Jira permissions', 'when will it…

mrDesign-ww/vault-os · 179 tokens

wrap

Use when ending a session, wrapping up, or saying "session end", "wrap up", "update files". Reviews the conversation and updates brain files, workflows, registry, and decisions log based on what happened.

ne11nn/cantos-plugin · 45 tokens

scroll-video

Build the foundation of an Apple-style scroll-driven video website — extract frames from a video, render them on canvas, and bind playback to scroll progress with a circle-wipe hero reveal.

ne11nn/cantos-plugin · 40 tokens

design-sub-agent

Use when planning, building, or auditing a sub-agent file. Guides frontmatter configuration, system prompt quality, and anti-pattern review before writing anything.

ne11nn/cantos-plugin · 34 tokens