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.
npx skills add samartomar/ai-harness --skill aih-betterdocgit clone --depth 1 https://github.com/samartomar/ai-harnessWrote 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.
[](https://agentmods.dev/skills/samartomar/ai-harness/aih-betterdoc)<a href="https://agentmods.dev/skills/samartomar/ai-harness/aih-betterdoc"><img src="https://agentmods.dev/badge/skills/samartomar/ai-harness/aih-betterdoc/github.svg" alt="Measured on agentmods" height="20"></a>Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.
<a href="https://agentmods.dev/skills/samartomar/ai-harness/aih-betterdoc"><img src="https://agentmods.dev/badge/skills/samartomar/ai-harness/aih-betterdoc.svg" alt="Reviewed on agentmods" width="80" height="20"></a>- NVIDIA SkillSpector pass
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.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5.1 | $0.00113 | $0.02325 |
| Opus 5 | $0.00056 | $0.01162 |
| Sonnet 5 | $0.00023 | $0.00465 |
| Haiku 4.5 | $0.00011 | $0.00232 |
Grade A, and why
aih-betterdoc scanned grade A with 0 findings 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 6d 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.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
How it starts
The opening of the file, as written. The whole thing — 301 lines — stays where its author put it; the contents beside it link to each section on GitHub.
BetterDoc (ai-harness)
This is the project-curated, CLI-neutral copy of the BetterDoc skill distributed
from packs/docs-quality/aih-betterdoc/. Load it through the repository's shared
canon routing. Do not create per-client copies or run AIH to install, refresh,
or validate it in this checkout.
BetterDoc improves documentation without weakening truth.
Use this skill when drafting, editing, reviewing, or restructuring public technical or product documentation. It does not authorize new product claims, private disclosures, implementation changes, publishing, or release actions.
Repository profile
Before editing public documentation, read:
ai-coding/rules/doc-and-truth-homes.mdfor public/private truth routing.PUBLIC_DOCS_POLICY.mdfor prohibited material and claims discipline.- The closest document-specific source of truth and the code, schemas, tests, generated artifacts, or CI evidence that support its claims.
docs/CONTROL_MATRIX.mdwhen the document describes controls, enforcement, or evidence surfaces.
This repository is public. Never copy strategy, competitive analysis, pricing,
customer information, private roadmap sequencing, maintainer runbooks, private
repository references, or session handoff text from the private companion into
public documentation. Sanitize examples and label demo data as required by
PUBLIC_DOCS_POLICY.md.
Never hand-edit generated or byte-locked documentation. Edit its renderer or
source. Never run AIH against this checkout, including to lint, regenerate, or
project documentation. Use direct repository checks such as
npm run docs:lint, focused tests, and the validation commands named by the
changed document's owning code.
Core rule
Do not trade correctness for smoothness.
A better document is:
- true,
- useful to the intended reader,
- scoped to what the source supports,
- easy to follow,
- clear and concise.
Clean prose is not enough. A polished unsupported claim is worse than a rough accurate sentence.
What ships with it
4 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.
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.
- 6d ago First seen · 301 lines · 113 tokens per session scan A bc4769f4a56f
aih-betterdoc is a skill published in the GitHub repository samartomar/ai-harness (6 stars, last pushed yesterday), licensed Apache-2.0. It adds 113 tokens to every session and 2,325 once invoked, about $0.0006 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-09-04.
Other skills, from other repositories
loading-addressable-markdown
Use when a mission, slice, dashboard, or task references Markdown as path#h2-slug or path#h2-slug/h3-slug outside the OpenRig context-pack library.
secrets-gitleaks
Hardcoded secret detection and prevention in git repositories and codebases using Gitleaks. Identifies passwords, API keys, tokens, and credentials through regex-based pattern matching and entropy analysis. Use when: (1) Scanning repositories for exposed secrets and credentials, (2) Implementing pre-commit hooks to…
A set of instructions for working with PDF files, which are documents designed to preserve their layout across devices.
pptx
A set of instructions for working with PowerPoint presentation files, including extracting content, editing slides, and creating decks.
oma-hwp
Convert HWP / HWPX / HWPML files to Markdown using kordoc. Extracts text, headings, tables, lists, images, footnotes, and hyperlinks. Use for Korean word processor files (Hangul), government documents, and AI-ready data preparation.
oma-pdf
Convert PDF files to Markdown using opendataloader-pdf. Extracts text, tables, headings, lists, and images with correct reading order. Use for PDF parsing, PDF to Markdown conversion, document extraction, and AI-ready data preparation.