one-time-surface SKILL.md skillA
one-time-surface from namedtoaster/the-last-mile is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add namedtoaster/the-last-mile/one-time-surface@git:20261018.bf92cbbPins git:20261018.bf92cbb in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 17 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- namedtoaster/the-last-mile
- Path
skills/one-time-surface/SKILL.md- Versions recorded
- 1
- Latest version
- git:20261018.bf92cbb, committed Oct 18, 2026
- Size
- 4,820 bytes
- Repository stars
- 14
- License
- MIT
Build or check a surface that is meant to appear once and then stop, such as a coach mark, tooltip, tour, primer, upsell card or review ask. Covers the three questions that decide whether it works for real people, not just on your phone, plus the traps that silently take it to zero. Use when adding a hint or one time card, when one is not appearing, when one keeps reappearing, or before shipping a surface you have only ever seen on your own device.
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
# One time surfaces A hint, a coach mark, a primer, a review ask. They share a failure mode: they look right on the device that built them and reach nobody, or everybody, twice. **Three questions decide whether yours works.** Each needs different evidence, and none of them is answered by looking at it on your own phone. | Question | What answers it | | --- | --- | | Does it appear at all, for someone who is not you? | Instrumentation, after a release. Nothing else | | Does it appear at the right moment? | Tests over the gates, plus one look on a device | | Does it stay gone once it has been seen? | The record you store, and a test of the rule | ## 1. Store a count, never a boolean A flag cannot express "three times, then stop", which is the rule that retires a surface before anyone is annoyed enough to dismiss it. Shipped consumer apps store counts, and more besides. Common shapes worth matching: - an impression **count** per surface - a **lifetime ceiling**, so it retires on its own - a **separate** dismissal record, because being seen and being dismissed are different events and the second is rarer than you expect …
Read the whole file at its exact version.
How to install
mdr add namedtoaster/the-last-mile/one-time-surface@sha256:86248d2e05d69a77The line at the top of this page pins the label git:20261018.bf92cbb, 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_qvedwfw6t7po7zrs)
1 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 1 version of this file, committed on Oct 18, 2026.
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 (4820 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
namedtoaster/the-last-mile · 14 stars · license MIT · pushed 2026-10-21 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_qvedwfw6t7po7zrs GET https://markdownregistry.com/api/v1/resolve?ref=namedtoaster/the-last-mile/one-time-surface GET https://markdownregistry.com/api/v1/blob/86248d2e05d69a77bce1d714cf50a76483bedf03d1f8a543a4d34b8033af26b2
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.