genius-file SKILL.md skillA

genius-file from donald-ada/workinggenius is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add donald-ada/workinggenius/genius-file@git:20261031.af1ac5b

Pins git:20261031.af1ac5b in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
donald-ada/workinggenius
Path
skills/genius-file/SKILL.md
Versions recorded
10
Latest version
git:20261031.af1ac5b, committed Oct 31, 2026
First version recorded
Sep 2, 2026
Size
7,234 bytes
Repository stars
6
License
MIT

Read and update Working Genius work files — the work's folder holding the bounded snapshot a cold session acts on, the append-only log behind it, and the contract that binds the unbuilt slices. Use when a stage skill needs the work-file discipline, when the user asks what work is in flight or where a piece of work left off, or before resuming any work tracked under .genius/.

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

# The Work File

One piece of work = one folder at `.genius/<slug>/` (a `## Working Genius` section in `CLAUDE.md`/`AGENTS.md` may pin a different parent), holding:

- the **snapshot** `<slug>.md`, the work's current truth, bounded
- the **log**, everything that happened on the way, append-only, as a tree: the root `<slug>.log.md` naming one branch per stage, slice or contract version under `log/`
- the **contract** `CONTRACT.md`, what binds the slices not yet built
- the work's own artifacts

The shape of all of it — templates, the compaction question, the ceiling and its instrument, the invariant, the link rules — is [FILE-FORMAT.md](FILE-FORMAT.md), the one home for those rules; the backlog's shape is [BACKLOG-FORMAT.md](BACKLOG-FORMAT.md), and the measurements behind the rules are [FORMAT-EDGES.md](FORMAT-EDGES.md).

The concept: **the files, not conversation memory, carry the work — and what a work knows grows by three different laws, so it gets three files with three different rules.** Conflate any two and the file grows with every discovery until nobody reads it closely, which is how a record dies while still being written to.

What that takes:
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add donald-ada/workinggenius/genius-file@sha256:1f899fe8edb5292d

The line at the top of this page pins the label git:20261031.af1ac5b, 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_4g25d56odcspjrmd.svg)](https://markdownregistry.com/a/art_4g25d56odcspjrmd)

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

Versions

The registry has recorded 10 versions of this file, between Sep 2, 2026 and Oct 31, 2026, about one every 7 days.

versioncommittedcommitsizeaudit
git:20261031.af1ac5b latest2026-10-31 af1ac5b 7,234 BA view · diff
git:20261003.51d97392026-10-03 51d9739 7,171 BA view · diff
git:20260925.6f9d20b2026-09-25 6f9d20b 7,167 BA view · diff
git:20260925.86b9d9e2026-09-25 86b9d9e 6,886 BA view · diff
git:20260925.8d07e012026-09-25 8d07e01 6,637 BA view · diff
git:20260906.f0d3db42026-09-06 f0d3db4 6,298 BA view · diff
git:20260906.efaff192026-09-06 efaff19 6,284 BA view · diff
git:20260905.b7b7ca32026-09-05 b7b7ca3 7,756 BA view · diff
git:20260905.a7ea1b42026-09-05 a7ea1b4 7,850 BA view · diff
git:20260902.f8897e92026-09-02 f8897e9 7,395 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 (7234 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

donald-ada/workinggenius · 6 stars · license MIT · pushed 2026-11-04 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_4g25d56odcspjrmd
GET https://markdownregistry.com/api/v1/resolve?ref=donald-ada/workinggenius/genius-file
GET https://markdownregistry.com/api/v1/blob/1f899fe8edb5292dcb0a1876d082011e88a7a5e04f4f396f785fff5e236d1382

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 donald-ada/workinggenius

CLAUDE.md CLAUDE.md file
donald-ada/workinggenius · CLAUDE.md
git:20261104.19ad3b7 · audit A · 6 stars
architect SKILL.md skill
donald-ada/workinggenius · skills/architect/SKILL.md · Answer build-or-adopt honestly, then design one committed architecture from your own understanding of the problem —…
git:20260925.8d07e01 · audit A · 6 stars
attack SKILL.md skill
donald-ada/workinggenius · skills/attack/SKILL.md · Put a plan, a design or a set of approaches the user hands over under blind attack, one attacker per path, and report…
git:20261003.51d9739 · audit A · 6 stars
blindspot SKILL.md skill
donald-ada/workinggenius · skills/blindspot/SKILL.md · Find the unknowns before they find the work — a read-only territory pass that surfaces the questions nobody knew to…
git:20261031.530e852 · audit A · 6 stars
compact SKILL.md skill
donald-ada/workinggenius · skills/compact/SKILL.md · Put the compaction question to a snapshot that drifted — route what no longer constrains unfinished work, and say what…
git:20261031.af1ac5b · audit A · 6 stars
decision-record SKILL.md skill
donald-ada/workinggenius · skills/decision-record/SKILL.md · Keep the index of the project's settled decisions in .genius/DECIDED.md — one line per decision, pointing at the fight…
git:20261003.51d9739 · audit A · 6 stars
designer SKILL.md skill
donald-ada/workinggenius · skills/designer/SKILL.md · Settle the look before the pixels — audience and context first, then the base and the delta, directions drawn as tiles…
git:20261003.51d9739 · audit A · 6 stars
diagnose SKILL.md skill
donald-ada/workinggenius · skills/diagnose/SKILL.md · Debugging as the six geniuses at minute scale — the bug confirmed by a red reproduction before any theory, hypotheses…
git:20261003.51d9739 · audit A · 6 stars
discern SKILL.md skill
donald-ada/workinggenius · skills/discern/SKILL.md · Explore the paths first where none are on record (the `invent` skill), then attack every path adversarially with one…
git:20261031.af1ac5b · audit A · 6 stars
domain-glossary SKILL.md skill
donald-ada/workinggenius · skills/domain-glossary/SKILL.md · Maintain the project's shared vocabulary in CONTEXT.md — challenge conflicting terms, sharpen fuzzy language, record…
git:20260925.8d07e01 · audit A · 6 stars
enable SKILL.md skill
donald-ada/workinggenius · skills/enable/SKILL.md · Build one slice at a time with red-before-green tests at the agreed seams, tight feedback loops, and fresh-eyes review…
git:20261104.19ad3b7 · audit A · 6 stars
errata SKILL.md skill
donald-ada/workinggenius · skills/errata/SKILL.md · Correct what was written wrong — the binding line rewritten in place, the record it came from appended to and never…
git:20261031.af1ac5b · audit A · 6 stars

Every file in donald-ada/workinggenius

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