writ SKILL.md skillB

writ from jlt-commons/writ is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add jlt-commons/writ/writ@git:20261005.b23544f

Pins git:20261005.b23544f in mdr.lock. Pin the fingerprint instead.

Audit grade
B, 16 of 17 checks passed
Kind
SKILL.md skill
Repository
jlt-commons/writ
Path
skills/writ/SKILL.md
Versions recorded
20
Latest version
git:20261005.b23544f, committed Oct 5, 2026
First version recorded
Sep 27, 2026
Size
69,968 bytes
Repository stars
16
License
Apache-2.0

Use when writing a writ spec -- the problem statement as a state graph and checkable laws about what code means and how it calls (writ.spec: spec/graph/refine/invariant/question/ann/data/law/assume/calls/flow/ machine/plan/elicit/obligations/attest) -- or its proof namespace (proof-of/lemma/hint), or the plain Clojure implementation it constrains, or when reading a writ.spec report or any "Writ:" error (purity, termination, ordering, arity, types, tagged data, failing, unproved, vacuous or…

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

# writ

writ checks plain Clojure against a spec of what the code is for. A spec
namespace is the problem statement in checkable form: it signs the public
fns and states laws about what their results mean. The implementation never
mentions writ. `(writ.spec/check 'my.spec)` runs Bend's static rules over
the implementation's source using those types, runs the laws, and then
checks that the laws actually pin the code down. It returns a report that
names what is wrong. writ runs on jolt; writ.spec uses test.check.

## Who owns what

- The spec (`spec`, `ann`, `data`, `law`) is the contract. A person or an
  agent may write it; once written, it is the contract. Do not weaken a
  law, loosen an `ann`, lower a `:require`, or delete any of them to get a
  check to pass. If the spec looks wrong, say so and ask. Do not answer or
  downgrade a blocking `question` yourself. `(spec/attest record 'my.spec)`
  compares a recorded check with the spec now and names every way it got
  weaker.
  A spec may hold itself to a record, `(spec my.ns {:baseline "path"})`:
  the check then fails on any weakening. Never write a new record to get
  a check through; that is the owner's call.
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add jlt-commons/writ/writ@sha256:36bf5392398caa39

The line at the top of this page pins the label git:20261005.b23544f, 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.

Badge

mdr badge

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

1 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 20 versions of this file, between Sep 27, 2026 and Oct 5, 2026, more than one a day.

versioncommittedcommitsizeaudit
git:20261005.b23544f latest2026-10-05 b23544f 69,968 BB view · diff
git:20261005.e77c3a62026-10-05 e77c3a6 69,020 BB view · diff
git:20261005.5c5d02c2026-10-05 5c5d02c 68,864 BB view · diff
git:20261005.2e4d73d2026-10-05 2e4d73d 68,675 BB view · diff
git:20261005.e6378ef2026-10-05 e6378ef 67,648 BB view · diff
git:20261003.8e8b8042026-10-03 8e8b804 61,011 BB view · diff
git:20261001.14e02082026-10-01 14e0208 57,900 BB view · diff
git:20261001.af518bc2026-10-01 af518bc 57,640 BB view · diff
git:20261001.05314142026-10-01 0531414 57,324 BB view · diff
git:20261001.2964f6e2026-10-01 2964f6e 57,133 BB view · diff
git:20260930.f36b86d2026-09-30 f36b86d 53,560 BB view · diff
git:20260930.8c83fdb2026-09-30 8c83fdb 53,506 BB view · diff
git:20260929.8ba59042026-09-29 8ba5904 52,758 BB view · diff
git:20260929.1170a1b2026-09-29 1170a1b 52,568 BB view · diff
git:20260929.94c34622026-09-29 94c3462 52,275 BB view · diff
git:20260927.80d01582026-09-27 80d0158 44,013 BB view · diff
git:20260927.b641aa72026-09-27 b641aa7 43,038 BB view · diff
git:20260927.f12e43b2026-09-27 f12e43b 40,968 BB view · diff
git:20260927.20174e02026-09-27 20174e0 43,726 BB view · diff
git:20260927.a1d7d012026-09-27 a1d7d01 42,751 BB view

Audit of the latest version

B  16 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • fail: No recursive delete of root, home or parent (matched: rm -rf ~/)
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (69968 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 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

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

GitHub

jlt-commons/writ · 16 stars · license Apache-2.0 · pushed 2026-11-05 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_sv66mdceqcivzhtq
GET https://markdownregistry.com/api/v1/resolve?ref=jlt-commons/writ/writ
GET https://markdownregistry.com/api/v1/blob/36bf5392398caa39e2fb92002a71cec8817fff175e40ce08e53cd1c994ce34a8

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.

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