rtfm

Spawn a zero-context tester to assess documentation usability and produce a structured gap report.

1|1|Updated Dec 30, 2025
One-click install
npx skills add https://github.com/0xHoneyJar/loa-constructs --skill rtfm
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: rtfm
Source: https://github.com/0xHoneyJar/loa-constructs/tree/main/.claude/skills/rtfm-testing
Command: npx skills add https://github.com/0xHoneyJar/loa-constructs --skill rtfm

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Spawns a zero-context tester to evaluate documentation usability, surfacing gaps and ambiguities that hinder newcomers.

Core Features & Use Cases

  • Hermetic document testing: isolates the test from project state to reveal gaps.
  • Gap reporting: produces a structured gap report and a formal verdict.
  • Canary-aware validation: validates context isolation to prevent leakage.

Quick Start

Invoke the RTFM Testing Skill with a target doc (e.g., README.md) to spawn the zero-context tester and generate a gap report.

Frequently Asked Questions about rtfm

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

FAQPage Schema
How do I find gaps in technical documentation using hermetic testing?

Documentation usability testing isolates a target doc like a README to evaluate completeness without external context. It spawns a zero-context tester that follows the RTFM process, validating canary checks to prevent context leakage and generating a structured gap report.

What is zero-context testing and how does it expose missing documentation?

Zero-context testing evaluates documentation usability by assuming no prior project knowledge. By isolating the test from project state, it reveals gaps and ambiguities in the docs that would otherwise be filled by a developer's internal context, ensuring newcomers can succeed.

How do I generate a structured gap report for my README?

To generate a gap report, invoke the RTFM testing process with a target doc such as README.md. The tester evaluates the document hermetically and writes a structured gap report to grimoires/loa/a2a/rtfm/report-{date}.md with a clear verdict.

Can I validate context leakage when testing documentation usability?

Yes, documentation usability testing includes canary-aware validation to ensure context isolation. This validates that no context leakage occurs during the hermetic test, guaranteeing the gap report accurately reflects the documentation's standalone clarity.

What does a partial or failure verdict mean in a documentation gap report?

A verdict of SUCCESS, PARTIAL, or FAILURE indicates whether the zero-context tester could navigate the documentation successfully. PARTIAL or FAILURE verdicts surface in the gap report when hermetic testing reveals missing information or ambiguities that hinder usability.

Do I need any dependencies or external tools to perform hermetic document testing?

No dependencies are required to perform hermetic document testing. The process spawns a zero-context tester that works solely with the provided target docs, requiring no external tools or prior environment setup to assess usability and generate a gap report.