ergonomics SKILL.md skillA

This file is byte-identical to the first copy the registry indexed. Same content hash, so the same checks give both the same grade.

ergonomics from boshu2/agentops is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add boshu2/agentops/ergonomics@git:20261025.a376884

Pins git:20261025.a376884 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
boshu2/agentops
Path
skills/ergonomics/SKILL.md
Versions recorded
4
Latest version
git:20261025.a376884, committed Oct 25, 2026
First version recorded
Oct 21, 2026
Size
10,250 bytes
Repository stars
453
License
Apache-2.0

Audit CLI, API, MCP or SDK discovery, first use and error recovery. Use when: designing an agent-facing tool or investigating misuse, including one command.

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

# Ergonomics

Judge a tool surface from the position of its most literal consumer, an AI
agent: a CLI, HTTP API, MCP or agent tool, SDK or library, or a proposed design
for one. A human developer is the second consumer and is usually served by the
same fixes. Neighbours: threats are [Security](../security/SKILL.md); help text
and READMEs are [Doc](../doc/SKILL.md); lasting proof is [Test](../test/SKILL.md);
applying fixes is [Implement](../implement/SKILL.md); acceptance is
[Validate](../validate/SKILL.md).

## The literal reader

An agent sees only text, exit codes and structured output. It has no screen,
no colour cue and often no terminal or open stdin. It copies the printed next
step and runs it as written. It cannot ask what a message meant. When something
fails it retries, and a retry after a mutation that may already have happened
is where a vague error costs the most. Read every help page, output and error
as that reader would, and ask what it does next.

## Select the mode

- **Plan mode** reads without running anything: a proposed interface (design
  doc, spec, draft help text, PR description), or the help and transcripts
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add boshu2/agentops/ergonomics@sha256:9a4a7a3342081156

The line at the top of this page pins the label git:20261025.a376884, 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_etymjnvdm6hzo2sq.svg)](https://markdownregistry.com/a/art_etymjnvdm6hzo2sq)

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

Versions

The registry has recorded 4 versions of this file, between Oct 21, 2026 and Oct 25, 2026, about one every day.

versioncommittedcommitsizeaudit
git:20261025.a376884 latest2026-10-25 a376884 10,250 BA view · diff
git:20261023.0c30caf2026-10-23 0c30caf 10,249 BA view · diff
git:20261021.71bc1e42026-10-21 71bc1e4 9,838 BA view · diff
git:20261021.b54da622026-10-21 b54da62 8,507 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 (10250 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

boshu2/agentops · 453 stars · license Apache-2.0 · pushed 2026-11-08 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_etymjnvdm6hzo2sq
GET https://markdownregistry.com/api/v1/resolve?ref=boshu2/agentops/ergonomics
GET https://markdownregistry.com/api/v1/blob/9a4a7a3342081156eb0790bd37987b3d4dcf59e42822116a6a8854dd8289873c

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 boshu2/agentops

AGENTS.md AGENTS.md file
boshu2/agentops · AGENTS.md
git:20261023.37429a6 · audit A · 453 stars
CLAUDE.md CLAUDE.md file
boshu2/agentops · CLAUDE.md
git:20260617.e46aede · audit B · 453 stars
AGENTS.md@cli AGENTS.md file
boshu2/agentops · cli/AGENTS.md
git:20261021.171baa2 · audit A · 453 stars
AGENTS.md@cli/internal/goals AGENTS.md file
boshu2/agentops · cli/internal/goals/AGENTS.md
git:20261023.37429a6 · audit A · 453 stars
AGENTS.md@cli/internal/quality AGENTS.md file
boshu2/agentops · cli/internal/quality/AGENTS.md
git:20261003.02f5f36 · audit A · 453 stars
AGENTS.md@cli/internal/types AGENTS.md file
boshu2/agentops · cli/internal/types/AGENTS.md
git:20260924.55c2c93 · audit A · 453 stars
AGENTS.md@cli/internal/types/quest AGENTS.md file
boshu2/agentops · cli/internal/types/quest/AGENTS.md
git:20260924.55c2c93 · audit A · 453 stars
implement SKILL.md skill
boshu2/agentops · packs/agentops-executor/agents/implementer-claude/skills/implement/SKILL.md · Execute one bounded RED to GREEN experiment from bead or caller intent; return derived subject identity and check…
git:20260729.a635979 · audit A · 453 stars
implement SKILL.md skill
boshu2/agentops · packs/agentops-executor/agents/implementer/skills/implement/SKILL.md · Execute one bounded RED to GREEN experiment from bead or caller intent; return derived subject identity and check…
git:20260729.a635979 · audit A · 453 stars
validate SKILL.md skill
boshu2/agentops · packs/agentops-executor/agents/validator/skills/validate/SKILL.md · Freshly judge exact subject content against bead or caller acceptance, optionally persist verdict.v2 for a declared…
git:20260926.482dc04 · audit A · 453 stars
using-gc SKILL.md skill
boshu2/agentops · packs/agentops-executor/skills/using-gc/SKILL.md · Operate a caller-selected Gas City 1.4 with upstream registry packs and native run-centered surfaces while keeping GC…
git:20260730.efcf487 · audit A · 453 stars
agent-native SKILL.md skill
boshu2/agentops · plugin/skills/agent-native/SKILL.md · Dispatch independent tasks to parallel workers or subagents without write collisions. Use when: running or planning…
git:20261031.73cbeae · audit A · 453 stars

Every file in boshu2/agentops

Other files named ergonomics

ergonomics SKILL.md skill
boshu2/agentops · plugin/skills/ergonomics/SKILL.md · Audit CLI, API, MCP or SDK discovery, first use and error recovery. Use when: designing an agent-facing tool or…
git:20261025.a376884 · audit A · 453 stars

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