shownotes-publisher SKILL.md skillA
shownotes-publisher from jbaruch/speaker-toolkit is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add jbaruch/speaker-toolkit/shownotes-publisher@git:20261021.aeef91cPins git:20261021.aeef91c in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 17 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- jbaruch/speaker-toolkit
- Path
skills/shownotes-publisher/SKILL.md- Versions recorded
- 8
- Latest version
- git:20261021.aeef91c, committed Oct 21, 2026
- First version recorded
- Sep 11, 2026
- Size
- 18,566 bytes
- Repository stars
- 22
- License
- none declared
Create and publish Jekyll shownotes pages and downloadable Agent Skills containing talk knowledge informed by rhetoric analysis. Use for "publish shownotes", "add talk to shownotes", "publish a skill for this talk", "update the talk skill", "add the video to shownotes", or speaking.jbaru.ch page updates. Supports pre-talk publishing from prepared notes and demos, post-event recordings, and skill refreshes. Encodes the custom shownotes parser's body format and single-file skill contract…
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
# Shownotes Publisher
Process steps in order. Do not skip ahead.
This skill writes a markdown file into the Jekyll shownotes site's `_talks/`
collection where a custom parser plugin (`_plugins/markdown_parser.rb` in the
target site) extracts structured fields by pattern matching on the body. The
format is strict — small mistakes silently flatten content or break
conditional rendering.
Resolve the absolute path of this loaded `SKILL.md`, then set
`speaker_toolkit_root` to the plugin root two directories above the directory
containing this file. Never derive it from the consumer working directory.
Treat `{speaker_toolkit_root}` as absolute in every toolkit-owned command;
talk and shownotes-site paths remain consumer-owned.
Reference files in this skill:
[references/parser-contract.md](references/parser-contract.md) —
extraction grammar per `extracted_*` field;
[references/template-conditionals.md](references/template-conditionals.md) —
how `talk.html` renders each field;
[references/common-mistakes.md](references/common-mistakes.md) —
13 failure modes with the right way;
[references/talk-skill.md](references/talk-skill.md) — content synthesis,
…Read the whole file at its exact version.
How to install
mdr add jbaruch/speaker-toolkit/shownotes-publisher@sha256:e77f57c3ad28735bThe line at the top of this page pins the label git:20261021.aeef91c, 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_ewo6j4mkhfxxxzxs)
3 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 8 versions of this file, between Sep 11, 2026 and Oct 21, 2026, about one every 6 days.
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| git:20261021.aeef91c latest | 2026-10-21 | aeef91c | 18,566 B | A | view · diff |
| git:20261021.4847f85 | 2026-10-21 | 4847f85 | 20,047 B | A | view · diff |
| git:20261021.4808dfc | 2026-10-21 | 4808dfc | 20,131 B | A | view · diff |
| git:20261020.56228d5 | 2026-10-20 | 56228d5 | 20,097 B | A | view · diff |
| git:20261020.ef161d6 | 2026-10-20 | ef161d6 | 20,090 B | A | view · diff |
| git:20260911.958d2b8 | 2026-09-11 | 958d2b8 | 19,935 B | A | view · diff |
| git:20260911.c947de5 | 2026-09-11 | c947de5 | 19,305 B | A | view · diff |
| git:20260911.d3cb134 | 2026-09-11 | d3cb134 | 18,845 B | A | view |
Audit of the latest version
- pass: Frontmatter block present
- pass: Frontmatter declares a name
- pass: Frontmatter declares a description
- pass: Size between 200 bytes and 200 KB (18566 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
- pass: No script tag
Source
jbaruch/speaker-toolkit · 22 stars · license none declared · pushed 2026-11-07 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_ewo6j4mkhfxxxzxs GET https://markdownregistry.com/api/v1/resolve?ref=jbaruch/speaker-toolkit/shownotes-publisher GET https://markdownregistry.com/api/v1/blob/e77f57c3ad28735bc32e020a50043c09835c4d8b09769ca994af2046f4ade122
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.