oma-docs

oma-docs is a skill for Claude Code, Codex from first-fluke/fullstack-starter. It costs 83 tokens per session (5,131 once invoked), scanned C, a copy of oma-docs, MIT.

A documentation-checking skill that compares Markdown documentation with the current codebase and checks translated documentation against its English source.

In plain words
What is it for?
Use it to verify documentation references, propose updates for changed code, detect translation drift, or check translated documents for specified style problems.
Why use it?
It finds stale file paths, commands, configuration names, and translations after code changes or before a release.

Skill for Claude CodeCodex

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.

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

Made for: Claude Code, Codex.

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/fullstack-starter/oma-docs.svg)](https://agentmods.dev/skills/first-fluke/fullstack-starter/oma-docs)
Your own site
<a href="https://agentmods.dev/skills/first-fluke/fullstack-starter/oma-docs"><img src="https://agentmods.dev/badge/skills/first-fluke/fullstack-starter/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. Scan, not verified.
Origin 100% copy Near-identical to another mod 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 $0.00083 $0.05131
Opus 5 $0.00042 $0.02566
Sonnet 5 $0.00017 $0.01026
Haiku 4.5 $0.00008 $0.00513

Measured today against content hash 9f804b96d0e4, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, 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 today.

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

This is a copy

100% identical to oma-docs — 0 lines differ, which has more behind it and is treated as the original. This page carries a canonical link to it rather than competing with it.

.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. today Changed 9f804b96d0e4
  2. yesterday First seen · 289 lines · 83 tokens per session scan C 6bc59428f92d

Subscribe to this mod's changes

oma-docs is a skill published in the GitHub repository first-fluke/fullstack-starter (222 stars, last pushed today), 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). It is 100% identical to oma-docs, differing in 0 lines, and is treated as a copy.

Related

Other skills, from other repositories

frontend-feature

Build a new page, view, or data-driven feature in the Next.js frontend. Use when adding a route under the dashboard/marketing area, wiring UI to a backend endpoint, adding client state, or creating a localized page. Covers App Router, data fetching, Zustand stores, and i18n.

vstorm-co/full-stack-ai-agent-template · 64 tokens

rag-knowledge

Work with the RAG knowledge base — ingest documents, run semantic search, manage collections, or add a sync source/connector (Google Drive, S3). Use when populating or debugging the knowledge base, tuning retrieval, or adding a new document source. This project uses {{ cookiecutter.vectorstore }} + {{…

vstorm-co/full-stack-ai-agent-template · 76 tokens

alembic-migration

Create, review, and apply database schema changes with Alembic. Use whenever a SQLAlchemy model is added or changed, a column/index/constraint needs to change, or a data backfill is required — anything that alters the PostgreSQL schema.

vstorm-co/full-stack-ai-agent-template · 56 tokens

intlayer-angular

Integrates Intlayer internationalization with Angular applications. Use when the user asks to "setup Angular i18n", create a new translated component, use the "useIntlayer" composable, or configure providers.

aymericzip/intlayer · 47 tokens

intlayer-next-js

Integrates Intlayer internationalization with Next.js App Router and Pages Router. Use when the user asks to "setup Next.js i18n", use "useIntlayer" in Server Components, or handle client-side translations in Next.js.

aymericzip/intlayer · 53 tokens

intlayer-react

Integrates Intlayer internationalization with React component. Use when the user asks to "setup React i18n", create a new translated component, use the "useIntlayer" hook, or configure providers.

aymericzip/intlayer · 46 tokens