crux skillA
crux is agent-read markdown (skill) from mehdiforoozandeh/crux: An agentic research companion — a scientific-method lab notebook for a research program. Organize work as a tree of Questions (what we don't know) and falsifiable Hypotheses (testable leaves), each with pre-registered verifiables and findings; a deterministic engine derives verdicts, rolls them up, and trips a human review gate. Use when the user wants to run a research program rigorously: open/track research questions, design experiments as problem-statement → hypothesis → verifiables → finding.
Indexed from public GitHub and served as immutable, content-addressed versions. Install it pinned to an exact SHA-256 with the mdr CLI, and every file is verified against the hash recorded here before it reaches your agent. The deterministic audit below grades the latest version, and the same file always earns the same grade.
What the file says
# crux — an agentic research companion `crux` turns a research program into a **scientific-method lab notebook**: a tree of **Questions** (what we don't know) and **Hypotheses** (falsifiable, testable leaves), rooted at a **Project**. A deterministic engine (`scaffold/`, a Python CLI) does the bookkeeping — IDs, the `Parent::` tree, validators, the evidence-ledger roll-up, the review gate, and regenerating `META.md` + `EXPERIMENTS.md`. The vault is plain markdown, openable in Obsidian (graph mode shows the question/hypothesis tree). You (the Agent) operate the engine on the researcher's behalf. The engine never judges; **you** supply the science and the researcher (the **PI**) makes the calls. ## When to use this The user is running a research program and wants it tracked rigorously: opening research questions, designing experiments as problem → hypothesis → verifiables → findings, recording results, deciding when a question is answered, and updating what's still open. Not for one-off tasks with no hypothesis, and not for launching the runs themselves (crux *records* runs; your training/job harness launches them). ## The model - **Project** — the root node, one per vault. …
Read the whole file at its exact version.
How to install
mdr add mehdiforoozandeh/crux/crux@v1.0mdr add mehdiforoozandeh/crux/crux@sha256:fb3ebe1e89594fafPin to a label to follow the author's releases, or to a sha256 to freeze the exact bytes forever. Either way the resolved hash is written to mdr.lock, and mdr install reproduces it on any machine.
[](https://markdownregistry.com/a/art_jvghwutlbae3mekx)
1 badge views in 30 days
Versions
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| v1.0 latest | 2026-09-20 | 0b94dad | 37,608 B | A | view · diff |
| v1.0 | 2026-09-18 | 1d07431 | 37,446 B | A | view · diff |
| v1.0 | 2026-09-17 | 90dc6bf | 36,736 B | A | view · diff |
| v1.0 | 2026-09-17 | bf6d9d7 | 35,419 B | A | view · diff |
| v1.0 | 2026-09-16 | 5414523 | 34,975 B | A | view · diff |
| v1.0 | 2026-08-31 | ca0e973 | 34,458 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 (37608 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
mehdiforoozandeh/crux · 6 stars · license MIT · pushed 2026-09-21 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_jvghwutlbae3mekx GET https://markdownregistry.com/api/v1/resolve?ref=mehdiforoozandeh/crux/crux GET https://markdownregistry.com/api/v1/blob/fb3ebe1e89594fafe4183db55c9d60345fff3562f6a20ae5742434342fae0f6b
Your agent 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.