octo-html SKILL.md skillB
octo-html from mininglamp-oss/octo-cli is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add mininglamp-oss/octo-cli/octo-html@v0.3.0Pins v0.3.0 in mdr.lock. Pin the fingerprint instead.
- Audit grade
- B, 16 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- mininglamp-oss/octo-cli
- Path
skills/octo-html/SKILL.md- Versions recorded
- 8
- Latest version
- v0.3.0, committed Oct 23, 2026
- First version recorded
- Jul 24, 2026
- Size
- 18,377 bytes
- Repository stars
- 920
- License
- Apache-2.0
HTML docs domain (octo-doc) — create and govern self-contained interactive HTML documents, immutable versions, drafts, sharing, media, comments, and agent element edits. Bots cannot delete documents. This is a DIFFERENT backend from the `octo-docs` (CRDT/Yjs) domain. Load after octo-shared.
Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.
What the file says
# octo-html — interactive HTML documents
> **This is NOT the `octo-docs` body-editing domain.** `octo-cli html …` talks
> to **octo-doc**, where a document is a self-contained HTML page published as
> immutable versions. `octo-cli docs …` talks to the separate CRDT/Yjs backend.
All commands call `$OCTO_API_BASE_URL/docs-html/v1/*` and return the standard
`{ok, identity, data, ...}` success envelope.
## Document-reference contract
- **Canonical create has no document reference.** Omit `slug` and provide
`html`. The CLI generates `idempotency_key`; an explicit key is optional. A display name belongs in `meta.title`;
it is metadata, not identity.
- **Save `data.slug` from the response.** New documents always return
`data.doc_id` and `data.slug`, with `data.slug == data.doc_id`, whether mounted
or unmounted. Use `data.slug` for every later operation.
- **Legacy documents keep their old reference.** For an old document, use its
legacy slug wherever this skill says `<doc-ref>`.
- **No alias identity and no same-name republish.** Creating again with the same
`meta.title` creates a different document. To publish another version, supply
…Read the whole file at its exact version.
How to install
mdr add mininglamp-oss/octo-cli/octo-html@sha256:6c0b17d0db6e9c38The line at the top of this page pins the label v0.3.0, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.
[](https://markdownregistry.com/a/art_vzrbf2pnr2ok4qa6)
3 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 8 versions of this file, between Jul 24, 2026 and Oct 23, 2026, about one every 13 days.
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| v0.3.0 latest | 2026-10-23 | 01e5e7c | 18,377 B | B | view · diff |
| v0.3.0 | 2026-10-22 | ed553a0 | 17,229 B | B | view · diff |
| v0.3.0 | 2026-10-20 | 3d39abd | 16,947 B | B | view · diff |
| v0.3.0 | 2026-09-24 | 55043e7 | 16,915 B | B | view · diff |
| v0.2.0 | 2026-09-18 | 92d4566 | 10,679 B | B | view · diff |
| v0.2.0 | 2026-08-18 | 274f5bf | 9,702 B | B | view · diff |
| v0.1.0 | 2026-08-18 | 0134bcb | 7,942 B | A | view · diff |
| v0.1.0 | 2026-07-24 | c27b81f | 7,911 B | B | view |
Audit of the latest version
- 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 (18377 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
Starting a new one? Use a template for SKILL.md on mdpantry, which passes every one of these checks and says what to change in it.
Source
mininglamp-oss/octo-cli · 920 stars · license Apache-2.0 · pushed 2026-10-23 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_vzrbf2pnr2ok4qa6 GET https://markdownregistry.com/api/v1/resolve?ref=mininglamp-oss/octo-cli/octo-html GET https://markdownregistry.com/api/v1/blob/6c0b17d0db6e9c3894865d9a7ee9e5632ab3141608f0032dd2ca55c21cb2f507
Your AI assistant 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.
Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.