agent-session SKILL.md skillA
agent-session from runxhq/runx is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add runxhq/runx/agent-session@git:20261105.fdab958Pins git:20261105.fdab958 in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 17 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- runxhq/runx
- Path
skills/agent-session/SKILL.md- Versions recorded
- 4
- Latest version
- git:20261105.fdab958, committed Nov 5, 2026
- First version recorded
- Oct 18, 2026
- Size
- 2,917 bytes
- Repository stars
- 104
- License
- Apache-2.0
Work one turn of a host's agent through runx. Read, search and ask in the read runner; also edit the workspace and run commands in the develop runner. Every call is admitted, recorded and receipted, and the turn ends with a summary of what it did.
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
# Agent session This is one turn of your work, run through runx. The act says why it exists. Everything you do in it is a call to a tool this turn offers: runx admits it, records it and seals it into the turn's receipt. There is nothing to do outside the calls. ## How to work - Read before you change anything. `fs.read`, `fs.list`, `fs.search` and the `git` tools return what is there, with each file's digest. `fs.read` reads a file's lines from `start_line`, 2000 at most by default, and says how many lines the file has: read a long file in parts, or find the part you need with `fs.search` first. - For the web, search with `exa.search.query`, then read the pages that matter with `web.page.read`. A search result is a lead, not a source: cite the page you read. - An edit names what it replaces. `fs.edit` replaces exact text; `fs.write` takes the digest you read, or `create: true` for a new file. A file that changed since you read it is refused: read it again. - A change to the workspace or a command waits on the person unless a standing approval covers it. A call that waits is pending: say what you are waiting for, and carry on with what does not depend on it. …
Read the whole file at its exact version.
How to install
mdr add runxhq/runx/agent-session@sha256:d34be1d13a764203The line at the top of this page pins the label git:20261105.fdab958, 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_kqoamaslj7t6luht)
3 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 4 versions of this file, between Oct 18, 2026 and Nov 5, 2026, about one every 6 days.
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| git:20261105.fdab958 latest | 2026-11-05 | fdab958 | 2,917 B | A | view · diff |
| git:20261021.b1f18f7 | 2026-10-21 | b1f18f7 | 2,617 B | A | view · diff |
| git:20261019.d9473c7 | 2026-10-19 | d9473c7 | 2,311 B | A | view · diff |
| git:20261018.0d5cfbe | 2026-10-18 | 0d5cfbe | 1,945 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 (2917 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
runxhq/runx · 104 stars · license Apache-2.0 · pushed 2026-11-05 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_kqoamaslj7t6luht GET https://markdownregistry.com/api/v1/resolve?ref=runxhq/runx/agent-session GET https://markdownregistry.com/api/v1/blob/d34be1d13a764203ee2e787175c62ce0e0bf638796442030585ee271aff5775e
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.