Home / tornado-doc / tdoc · skills/tdoc/SKILL.md · GitHub

tdoc skillB

tdoc is agent-read markdown (skill) from tornado-doc/tdoc: Prompt-native HTML docs. Generate a self-contained HTML document from a prompt (SVG diagrams, CSS-toggled models, explainers, strategy docs, research write-ups, product specs, explainer pages, design docs, RFCs, case studies, post-mortems, technical proposals, vision docs, one-pagers, decision frameworks), publish it to a free shareable link on tdoc.dev, and collect text- and artifact-anchored comments that regenerate the next version. Readers need nothing installed. Self-hosting on your own Clo.

Indexed from public GitHub and served as immutable, content-addressed versions. Install it pinned to an exact SHA-256 with the mdr CLI, and every file is verified against the hash recorded here before it reaches your agent. The deterministic audit below grades the latest version, and the same file always earns the same grade.

What the file says

# tdoc — Prompt-native HTML documents

Open-source, collaborative. Docs are HTML build
artifacts, not files the user maintains.

**Source of truth (see `AGENTS.md`):** Remote storage is source of truth. Local HTML is disposable. Local skill is authoring/scaffold. Authoring interface is a prompt.
Every edit creates a new version. Comments anchor to highlighted text or to
artifacts (images, SVG, canvas, video) and are used to regenerate the next
version. Each user publishes to their own Cloudflare Worker for free always-on
sharing, with a one-time sign-in (email, Google, or GitHub) gating comments.

## Storage layout

```
~/tdocs/
  <slug>/
    meta.json          # { title, created, versions: [...] }
    v1/index.html
    v1/widgets/<name>.html  # optional; sandboxed JS island, served at /widget/<name>
    v2/index.html
    comments.json      # [{ id, version, anchor, text, status }]
```

Server runs at `http://localhost:7878` (override with `TDOC_PORT`) and serves:
- `/` — index of all docs
- `/d/<slug>/v/<n>` — a specific version (reader shell + the author document in an isolated frame)
- `/d/<slug>/v/<n>/widget/<name>` — sandboxed interactive island (no reader chrome)
…

Read the whole file at its exact version.

How to install

Latest version
mdr add tornado-doc/tdoc/tdoc@git:20260923.2052a41
Exact content
mdr add tornado-doc/tdoc/tdoc@sha256:0e792fe97b74f0c0

Pin to a label to follow the author's releases, or to a sha256 to freeze the exact bytes forever. Either way the resolved hash is written to mdr.lock, and mdr install reproduces it on any machine.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_uzzv4qiqnwsze3t3.svg)](https://markdownregistry.com/a/art_uzzv4qiqnwsze3t3)

1 badge views in 30 days

Versions

versioncommittedcommitsizeaudit
git:20260923.2052a41 latest2026-09-23 2052a41 72,145 BB view · diff
git:20260909.6c860462026-09-09 6c86046 70,686 BB view · diff
git:20260909.d74c2222026-09-09 d74c222 70,315 BB view · diff
git:20260903.fa4ee2f2026-09-03 fa4ee2f 69,709 BB view · diff
git:20260903.718f8e52026-09-03 718f8e5 83,353 BB view · diff
git:20260902.53ceecb2026-09-02 53ceecb 82,529 BB view

Audit of the latest version

B  16 of 17 checks passed. Deterministic, no model, same answer every run.
  • fail: No script tag (matched: <script)
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (72145 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address

Source

GitHub

tornado-doc/tdoc · 103 stars · license AGPL-3.0 · pushed 2026-09-25 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_uzzv4qiqnwsze3t3
GET https://markdownregistry.com/api/v1/resolve?ref=tornado-doc/tdoc/tdoc
GET https://markdownregistry.com/api/v1/blob/0e792fe97b74f0c06abb01ed59640d9c3993e73f386a5c070eb36a61ce292ad2

Your agent does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

More from tornado-doc/tdoc

AGENTS.md agents
tornado-doc/tdoc · AGENTS.md
git:20260923.d0f65dd · audit A · 103 stars
tdoc skill
tornado-doc/tdoc · SKILL.md · Prompt-native HTML docs. Generate a self-contained HTML document from a prompt (SVG diagrams, CSS-toggled models…
git:20260923.af39a9f · audit B · 103 stars

Every file in tornado-doc/tdoc

Other files named tdoc

tdoc skill
tornado-doc/tdoc · SKILL.md · Prompt-native HTML docs. Generate a self-contained HTML document from a prompt (SVG diagrams, CSS-toggled models…
git:20260923.af39a9f · audit B · 103 stars

Browse by kind, by grade B, or by owner.