geas SKILL.md skillA

geas from i2y/ritsu is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add i2y/ritsu/geas@git:20261028.c70f3b0

Pins git:20261028.c70f3b0 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
i2y/ritsu
Path
skills/geas/SKILL.md
Versions recorded
5
Latest version
git:20261028.c70f3b0, committed Oct 28, 2026
First version recorded
Oct 4, 2026
Size
22,965 bytes
Repository stars
3
License
Apache-2.0

Hold code to claims a person has read, with geas. A `.geas` file holds claims about what a program does as anyone could observe it from outside (what a command prints and exits with, what an HTTP service answers, what a screen shows), and geas runs every claim against the real program, whatever language it is written in. Use when writing or changing code that a `.geas` claims file holds; when running the gate on a change (`ritsu geas check`, `drift`, `map` and `affected`); when a claim fails…

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

## When this applies

The project keeps a **claims file** (`*.geas`) beside its code, or a person wants one. Each claim
says what the program does as anyone could see it from outside: what a command prints and exits
with, what an HTTP service answers, what a screen shows to a screen reader. The person reads and
accepts the claims; you write the code; `ritsu geas check` runs every claim against the real program and
says which hold.

It does not apply to tests of internal functions: a claim never names a file, a function, a class,
a CSS selector or a line, and geas never reaches into the code. A library is claimed through a
small command or service around it.

The files bundled with this skill are listed in §10. Read them when you need them, not all up
front.

---

# Working with geas

## 1. Who writes what

geas splits the work: the person reads about fifty lines of claims, you write the code, and geas
holds the code to the claims. That split is the whole point, so keep to it.

- **The claims file is the person's.** Every line of it: the claims, the targets, the masks, the
  pins. Do not change it to make the gate pass. Write a change you think it needs as text in your
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add i2y/ritsu/geas@sha256:59520939b09e4a64

The line at the top of this page pins the label git:20261028.c70f3b0, 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_bajkpvsw36oyi5sr.svg)](https://markdownregistry.com/a/art_bajkpvsw36oyi5sr)

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

Versions

The registry has recorded 5 versions of this file, between Oct 4, 2026 and Oct 28, 2026, about one every 6 days.

versioncommittedcommitsizeaudit
git:20261028.c70f3b0 latest2026-10-28 c70f3b0 22,965 BA view · diff
git:20261006.922bf712026-10-06 922bf71 21,253 BA view · diff
git:20261005.cc21e442026-10-05 cc21e44 20,877 BA view · diff
git:20261004.634440d2026-10-04 634440d 19,898 BA view · diff
git:20261004.d3273b22026-10-04 d3273b2 19,477 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (22965 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

GitHub

i2y/ritsu · 3 stars · license Apache-2.0 · pushed 2026-11-07 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_bajkpvsw36oyi5sr
GET https://markdownregistry.com/api/v1/resolve?ref=i2y/ritsu/geas
GET https://markdownregistry.com/api/v1/blob/59520939b09e4a64d9792f261184bd88798bdee49a1b7327d6772aca1e577cfd

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.

More from i2y/ritsu

DESIGN.md DESIGN.md file
i2y/ritsu · DESIGN.md
git:20261107.d281d9c · audit F · 3 stars
DESIGN.md@crates/chobo DESIGN.md file
i2y/ritsu · crates/chobo/DESIGN.md
git:20261106.2acffb3 · audit B · 3 stars
DESIGN.md@crates/dandori DESIGN.md file
i2y/ritsu · crates/dandori/DESIGN.md
git:20261104.62ba97a · audit C · 3 stars
DESIGN.md@crates/geas DESIGN.md file
i2y/ritsu · crates/geas/DESIGN.md
git:20261031.76f9a81 · audit B · 3 stars
DESIGN.md@crates/kaname DESIGN.md file
i2y/ritsu · crates/kaname/DESIGN.md
git:20261107.d281d9c · audit B · 3 stars
DESIGN.md@crates/koyomi DESIGN.md file
i2y/ritsu · crates/koyomi/DESIGN.md
git:20261107.d281d9c · audit B · 3 stars
AGENTS.md@crates/rulec AGENTS.md file
i2y/ritsu · crates/rulec/AGENTS.md
git:20261103.7af3d08 · audit A · 3 stars
DESIGN.md@crates/rulec DESIGN.md file
i2y/ritsu · crates/rulec/DESIGN.md
git:20261106.947564f · audit C · 3 stars
DESIGN.md@crates/sakai DESIGN.md file
i2y/ritsu · crates/sakai/DESIGN.md
git:20261107.d281d9c · audit B · 3 stars
DESIGN.md@crates/sekisho DESIGN.md file
i2y/ritsu · crates/sekisho/DESIGN.md
git:20261103.558b890 · audit C · 3 stars
DESIGN.md@crates/yuen DESIGN.md file
i2y/ritsu · crates/yuen/DESIGN.md
git:20261105.54d3620 · audit B · 3 stars
chobo SKILL.md skill
i2y/ritsu · skills/chobo/SKILL.md · Write, check and build chobo books (`.book` files), a small language for the things counted and moved between accounts…
git:20261104.5b400fc · audit A · 3 stars

Every file in i2y/ritsu

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