Home / martinholovsky / sota-skills · GitHub

AGENTS.mdA

AGENTS.md from martinholovsky/sota-skills is an AGENTS.md file: the standing instructions coding agents read in that repo.

Install it, pinned
mdr add martinholovsky/sota-skills/AGENTS.md@git:20261016.735fde2

Pins git:20261016.735fde2 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 14 of 14 checks passed
Kind
AGENTS.md file
Repository
martinholovsky/sota-skills
Path
AGENTS.md
Versions recorded
49
Latest version
git:20261016.735fde2, committed Oct 16, 2026
First version recorded
Sep 1, 2026
Size
16,065 bytes
Repository stars
23
License
CC-BY-4.0

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

# AGENTS.md

Operational guidance for AI assistants (and humans) working **on** this repository. This
is the SOTA-skills library — Markdown skills that an AI assistant reads to build and
audit software. There is no application to run; changes are edits to Markdown held to a
few hard invariants. See [CONTRIBUTING.md](CONTRIBUTING.md) for the full conventions.

This file is the single source of truth for every agent: tools that follow the
[AGENTS.md standard](https://agents.md) (Codex, Cursor, Copilot, …) read it directly,
while `CLAUDE.md` (Claude Code) and `GEMINI.md` (Gemini CLI) are symlinks to it — edit
only this file, never the symlinks.

## Landing a change

`main` is a protected branch and **direct pushes are rejected for everyone** (admin
enforcement is on). Every change goes through a pull request:

1. `git checkout -b <branch>`
2. make the edit, then run `./scripts/check-invariants.sh` (and optionally
   `pre-commit run --all-files`). `pre-commit install` sets up **both** stages —
   pre-push re-runs the invariants, the first moment the **diff-based** ones
   (11, 14) have a commit to read. **Neither runs CI's other steps**: touched a skill file?
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add martinholovsky/sota-skills/AGENTS.md@sha256:3ce6f8fde46f43f7

The line at the top of this page pins the label git:20261016.735fde2, 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_bstpxbp7r6xihrgp.svg)](https://markdownregistry.com/a/art_bstpxbp7r6xihrgp)

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

Versions

The registry has recorded 49 versions of this file, between Sep 1, 2026 and Oct 16, 2026, more than one a day.

versioncommittedcommitsizeaudit
git:20261016.735fde2 latest2026-10-16 735fde2 16,065 BA view · diff
git:20261012.50f62de2026-10-12 50f62de 16,000 BA view · diff
git:20261012.293de9f2026-10-12 293de9f 15,925 BA view · diff
git:20261009.905abaf2026-10-09 905abaf 15,754 BA view · diff
git:20261009.1d195302026-10-09 1d19530 15,598 BA view · diff
git:20261007.46631ca2026-10-07 46631ca 15,485 BA view · diff
git:20261007.a8460612026-10-07 a846061 15,385 BA view · diff
git:20261007.40b6c5a2026-10-07 40b6c5a 15,302 BA view · diff
git:20260930.1efc1212026-09-30 1efc121 15,222 BA view · diff
git:20260929.11968ba2026-09-29 11968ba 15,147 BA view · diff
git:20260929.b777e8a2026-09-29 b777e8a 15,116 BA view · diff
git:20260926.e89beb12026-09-26 e89beb1 15,010 BA view · diff
git:20260925.0da81062026-09-25 0da8106 14,876 BA view · diff
git:20260925.9af12262026-09-25 9af1226 14,869 BA view · diff
git:20260925.51daf1f2026-09-25 51daf1f 14,828 BA view · diff
git:20260925.25d5dd12026-09-25 25d5dd1 14,847 BA view · diff
git:20260924.cfe6bcb2026-09-24 cfe6bcb 14,814 BA view · diff
git:20260923.86b0d8a2026-09-23 86b0d8a 14,664 BA view · diff
git:20260923.af339c42026-09-23 af339c4 14,595 BA view · diff
git:20260923.e1b20d82026-09-23 e1b20d8 14,557 BA view · diff
git:20260920.f7e09022026-09-20 f7e0902 13,834 BA view · diff
git:20260918.9ce6fc52026-09-18 9ce6fc5 13,414 BA view · diff
git:20260916.06389c42026-09-16 06389c4 13,385 BA view · diff
git:20260916.e1e1b122026-09-16 e1e1b12 13,385 BA view · diff
git:20260914.e98e0472026-09-14 e98e047 13,144 BA view · diff
git:20260914.47357552026-09-14 4735755 13,152 BA view · diff
git:20260914.2f416312026-09-14 2f41631 13,011 BA view · diff
git:20260913.396fdf12026-09-13 396fdf1 13,007 BA view · diff
git:20260913.f0ecd452026-09-13 f0ecd45 12,939 BA view · diff
git:20260912.e3c5f412026-09-12 e3c5f41 19,198 BA view · diff
git:20260912.2574dad2026-09-12 2574dad 19,182 BA view · diff
git:20260911.cff623d2026-09-11 cff623d 19,184 BA view · diff
git:20260911.9cd2dc72026-09-11 9cd2dc7 19,113 BA view · diff
git:20260910.563179b2026-09-10 563179b 19,079 BA view · diff
git:20260909.0a28ce52026-09-09 0a28ce5 18,855 BA view · diff
git:20260909.582d6f92026-09-09 582d6f9 18,670 BA view · diff
git:20260909.3287ca52026-09-09 3287ca5 18,070 BA view · diff
git:20260909.799dd4e2026-09-09 799dd4e 18,070 BA view · diff
git:20260909.bcb0ea42026-09-09 bcb0ea4 17,269 BA view · diff
git:20260908.1f82c862026-09-08 1f82c86 16,965 BA view · diff
git:20260907.41639b62026-09-07 41639b6 16,965 BA view · diff
git:20260907.99ab7562026-09-07 99ab756 16,882 BA view · diff
git:20260906.5bf121f2026-09-06 5bf121f 16,884 BA view · diff
git:20260906.37f2b422026-09-06 37f2b42 16,149 BA view · diff
git:20260905.833c5782026-09-05 833c578 16,249 BA view · diff
git:20260905.fc5a9192026-09-05 fc5a919 15,836 BA view · diff
git:20260904.ca30d1b2026-09-04 ca30d1b 15,507 BA view · diff
git:20260903.92b613f2026-09-03 92b613f 15,135 BA view · diff
git:20260901.133ab1d2026-09-01 133ab1d 15,043 BA view

Audit of the latest version

A  14 of 14 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Size between 200 bytes and 200 KB (16065 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

martinholovsky/sota-skills · 23 stars · license CC-BY-4.0 · pushed 2026-10-21 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_bstpxbp7r6xihrgp
GET https://markdownregistry.com/api/v1/resolve?ref=martinholovsky/sota-skills/AGENTS.md
GET https://markdownregistry.com/api/v1/blob/3ce6f8fde46f43f7e5a8665c33b781aa0387fa9d85a81ec6ce6f9a4f62af1792

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: how to write a good AGENTS.md · AGENTS.md vs CLAUDE.md · which agent file does what.

More from martinholovsky/sota-skills

CLAUDE.md CLAUDE.md file
martinholovsky/sota-skills · CLAUDE.md
git:20260703.aaa9f67 · audit B · 23 stars
sota-api-design SKILL.md skill
martinholovsky/sota-skills · skills/sota-api-design/SKILL.md · State-of-the-art API design and audit guidance (2026) covering REST/HTTP, GraphQL, gRPC, WebSockets/SSE/realtime…
git:20261012.ae1b29b · audit A · 23 stars
sota-architecture SKILL.md skill
martinholovsky/sota-skills · skills/sota-architecture/SKILL.md · State-of-the-art software and system architecture rules (2026) for both building and auditing. Use when designing…
git:20261012.ae1b29b · audit A · 23 stars
sota-async-concurrency SKILL.md skill
martinholovsky/sota-skills · skills/sota-async-concurrency/SKILL.md · State-of-the-art rules for writing and auditing asynchronous and concurrent code across runtimes (Python asyncio…
git:20261012.ae1b29b · audit A · 23 stars
sota-c-cpp SKILL.md skill
martinholovsky/sota-skills · skills/sota-c-cpp/SKILL.md · State-of-the-art C and C++ engineering rules that Claude applies when writing or auditing C/C++. Covers modern idioms…
git:20261012.ae1b29b · audit A · 23 stars
sota-cli-ux SKILL.md skill
martinholovsky/sota-skills · skills/sota-cli-ux/SKILL.md · State-of-the-art CLI and developer-tool UX guidance (2026) covering command and flag design, output and interaction…
git:20261012.ae1b29b · audit A · 23 stars
sota-cloud-infrastructure SKILL.md skill
martinholovsky/sota-skills · skills/sota-cloud-infrastructure/SKILL.md · State-of-the-art cloud infrastructure architecture (2026). Applies when designing, building, or auditing cloud…
git:20261012.ae1b29b · audit A · 23 stars
sota-code-security SKILL.md skill
martinholovsky/sota-skills · skills/sota-code-security/SKILL.md · Secure coding and security auditing rules. Use whenever BUILDING or modifying code that crosses a trust boundary —…
git:20261012.ae1b29b · audit A · 23 stars
sota-confidential-computing SKILL.md skill
martinholovsky/sota-skills · skills/sota-confidential-computing/SKILL.md · State-of-the-art confidential computing and cryptographic PETs (2026) for BUILDING and AUDITING systems that protect…
git:20261012.ae1b29b · audit A · 23 stars
sota-copywriting SKILL.md skill
martinholovsky/sota-skills · skills/sota-copywriting/SKILL.md · State-of-the-art marketing copywriting and content guidance (2026) covering positioning and value propositions…
git:20261012.ae1b29b · audit A · 23 stars
sota-data-engineering SKILL.md skill
martinholovsky/sota-skills · skills/sota-data-engineering/SKILL.md · State-of-the-art data engineering rules (2026) for building and auditing data pipelines and analytics infrastructure…
git:20261012.ae1b29b · audit A · 23 stars
sota-databases SKILL.md skill
martinholovsky/sota-skills · skills/sota-databases/SKILL.md · State-of-the-art database engineering rules (2026) for designing, building, and auditing data layers. Covers engine…
git:20261012.ae1b29b · audit A · 23 stars

Every file in martinholovsky/sota-skills

Other files named AGENTS.md

AGENTS.md AGENTS.md file
morluto/rea · AGENTS.md
git:20261015.0e1f0bf · audit A · 352,890 stars
AGENTS.md AGENTS.md file
obra/superpowers · AGENTS.md
git:20260919.5bf4e78 · audit A · 302,424 stars
AGENTS.md AGENTS.md file
affaan-m/ecc · AGENTS.md
git:20261011.412347a · audit A · 284,510 stars
AGENTS.md AGENTS.md file
firecrawl/firecrawl · AGENTS.md
git:20261008.5a75dca · audit A · 193,096 stars
AGENTS.md AGENTS.md file
dietrichgebert/ponytail · AGENTS.md
git:20261008.2a1fe84 · audit A · 170,980 stars
AGENTS.md AGENTS.md file
garrytan/gstack · AGENTS.md
git:20261011.5d64745 · audit A · 136,966 stars
AGENTS.md AGENTS.md file
graphify-labs/graphify · AGENTS.md
git:20260926.98d73fe · audit A · 129,649 stars
AGENTS.md AGENTS.md file
juliusbrussee/caveman · AGENTS.md
git:20260902.d9faebc · audit A · 113,780 stars

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