agent-system-design SKILL.md skillA

agent-system-design from akillness/jeo-skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add akillness/jeo-skills/agent-system-design@git:20260920.2a2b733

Pins git:20260920.2a2b733 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
akillness/jeo-skills
Path
.agent-skills/agent-system-design/SKILL.md
Versions recorded
2
Latest version
git:20260920.2a2b733, committed Sep 20, 2026
First version recorded
Sep 19, 2026
Size
3,844 bytes
Repository stars
52
License
none declared

Production agent SLA discipline — MAX_LOOPS, MAX_TOKENS, MAX_COST, MAX_LATENCY, MAX_TOOL_CALLS, circuit breakers, sovereignty boundaries, degradation modes. Use before deploying any autonomous loop to production.

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 System Design

## Overview

Demos run forever; production cannot. This skill defines the **five budgets** every production agent must enforce, the circuit breakers that stop runaway loops, and the sovereignty rules that keep agents from straying outside their domain.

## When to use

- Moving an agent from prototype to production
- An agent looped, spent $200, and produced nothing useful
- You can't answer "what is this agent allowed to do?" in one sentence
- Need to set SLO/SLA with stakeholders
- Multi-agent system where one agent can call another

## The five budgets

| Budget | Default cap | When exceeded |
|--------|-------------|---------------|
| `MAX_LOOPS` | 25 iterations | Stop, hand to human |
| `MAX_TOKENS` | 200k per run | Summarize state, restart |
| `MAX_COST_USD` | $2 per run | Hard stop, page operator |
| `MAX_LATENCY_S` | 300s wall clock | Return partial, log incomplete |
| `MAX_TOOL_CALLS` | 50 per run | Stop, suspicious behavior |

Caps are **per run**, enforced by the harness, not by prompting the LLM.

## Loop termination rules

Stop when ANY of these is true:
1. Goal verified (tests pass / acceptance criteria met)
2. Budget cap hit
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add akillness/jeo-skills/agent-system-design@sha256:2250a620a8c06db1

The line at the top of this page pins the label git:20260920.2a2b733, 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_xzysb6yllhya5sjv.svg)](https://markdownregistry.com/a/art_xzysb6yllhya5sjv)

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

Versions

The registry has recorded 2 versions of this file, between Sep 19, 2026 and Sep 20, 2026, about one every day.

versioncommittedcommitsizeaudit
git:20260920.2a2b733 latest2026-09-20 2a2b733 3,844 BA view · diff
git:20260919.9f2a9082026-09-19 9f2a908 3,850 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 (3844 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

akillness/jeo-skills · 52 stars · license none declared · pushed 2026-11-05 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_xzysb6yllhya5sjv
GET https://markdownregistry.com/api/v1/resolve?ref=akillness/jeo-skills/agent-system-design
GET https://markdownregistry.com/api/v1/blob/2250a620a8c06db1aef940dd8e48b599f35b5f2bb97a86b7138f97f0bcb77074

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 akillness/jeo-skills

a2a-protocol SKILL.md skill
akillness/jeo-skills · .agent-skills/a2a-protocol/SKILL.md · Agent-to-Agent horizontal messaging — Linux Foundation AAIF 2026 standard. Use when multiple agents across…
git:20260920.2a2b733 · audit A · 52 stars
ab-test-analysis SKILL.md skill
akillness/jeo-skills · .agent-skills/ab-test-analysis/SKILL.md · Analyze A/B test results with statistical significance, sample size validation, confidence intervals, and…
git:20260919.9f2a908 · audit A · 52 stars
academic-research SKILL.md skill
akillness/jeo-skills · .agent-skills/academic-research/SKILL.md · Full academic research pipeline from discovery to publication — 4 reference pipelines, 27 modes, 39-agent ensemble…
v1.0.0 · audit A · 52 stars
agent-beacon SKILL.md skill
akillness/jeo-skills · .agent-skills/agent-beacon/SKILL.md · Operate Asymptote-Labs/agent-beacon, the cross-harness coding-agent session history and self-improving memory layer…
v1.0.0 · audit A · 52 stars
agent-benchmarking SKILL.md skill
akillness/jeo-skills · .agent-skills/agent-benchmarking/SKILL.md · Map agent capabilities to standard benchmarks (SWE-bench, WebArena, OSWorld, GAIA, TauBench) plus custom regression…
git:20260919.9f2a908 · audit A · 52 stars
agent-guardrails SKILL.md skill
akillness/jeo-skills · .agent-skills/agent-guardrails/SKILL.md · Layered agent safety — prompt-injection defense, data exfiltration prevention, tool-misuse blocking via NeMo Guardrails…
git:20260919.9f2a908 · audit B · 52 stars
agent-manager SKILL.md skill
akillness/jeo-skills · .agent-skills/agent-manager/SKILL.md · tmux + Python agent lifecycle manager — start, stop, monitor, and assign tasks to AI agents running in tmux sessions…
v1.0 · audit A · 52 stars
agent-memory-architecture SKILL.md skill
akillness/jeo-skills · .agent-skills/agent-memory-architecture/SKILL.md · Design tiered agent memory — core / recall / archival — with backend selection (mem0, Letta, Zep/Graphiti, LangMem) and…
git:20260919.9f2a908 · audit A · 52 stars
agent-observability SKILL.md skill
akillness/jeo-skills · .agent-skills/agent-observability/SKILL.md · Instrument LLM agents with traces, metrics, and replay. Use when an agent in production is silently failing…
git:20260919.9f2a908 · audit A · 52 stars
agent-principles SKILL.md skill
akillness/jeo-skills · .agent-skills/agent-principles/SKILL.md · Core principles for collaborative development with AI agents. Defines divide-and-conquer, context management…
v2.0.0 · audit A · 52 stars
agent-pulse SKILL.md skill
akillness/jeo-skills · .agent-skills/agent-pulse/SKILL.md · Operate and extend barretlee/agent-pulse, the evidence-backed AI industry intelligence system: inspect source catalog…
v1.0 · audit A · 52 stars
agent-reach SKILL.md skill
akillness/jeo-skills · .agent-skills/agent-reach/SKILL.md · Operate Panniantong/Agent-Reach, the MIT-licensed installer, doctor, and routing layer for platform-specific internet…
v1.0.0 · audit A · 52 stars

Every file in akillness/jeo-skills

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