AGENTS.mdA

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

Install it, pinned
mdr add bretfisher/skills/AGENTS.md@git:20261106.9ca18d3

Pins git:20261106.9ca18d3 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 14 of 14 checks passed
Kind
AGENTS.md file
Repository
bretfisher/skills
Path
AGENTS.md
Versions recorded
13
Latest version
git:20261106.9ca18d3, committed Nov 6, 2026
First version recorded
Aug 31, 2026
Size
12,759 bytes
Repository stars
21
License
MIT

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 guide for this repo

This repo holds reusable [Agent Skills](https://docs.claude.com/en/docs/agents-and-tools/agent-skills) for DevOps / platform work.
Read this before creating, editing, or evaluating a skill.

## Layout

```text
plugins/<group>/              # one plugin per group: devops (bretfisher-devops) and utils (bretfisher-utils, everything else)
  plugin.json                 #   Agent Plugins 1.0.0 manifest (Codex reads it); .claude-plugin/ and .cursor-plugin/ hold the same metadata
  skills/<skill-name>/        #   SOURCE — committed; a plugin install copies the whole plugin folder
    SKILL.md                  #     the skill itself: description, working style, checklist, validate, done-when
    references/*.md           #     detail read only when a branch needs it (rules + why, procedures)
    scripts/*                 #     deterministic helpers the skill runs (linted, --help, structured output)
    agents/openai.yaml        #     Codex display name and short description (and invocation policy when SKILL.md sets one)
skills-devops, skills-utils   # symlinks to plugins/devops/skills and plugins/utils/skills, for browsing only
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add bretfisher/skills/AGENTS.md@sha256:7e21baecf8bf2c9e

The line at the top of this page pins the label git:20261106.9ca18d3, 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_g4gptqlj5ckzq7v3.svg)](https://markdownregistry.com/a/art_g4gptqlj5ckzq7v3)

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

Versions

The registry has recorded 13 versions of this file, between Aug 31, 2026 and Nov 6, 2026, about one every 6 days.

versioncommittedcommitsizeaudit
git:20261106.9ca18d3 latest2026-11-06 9ca18d3 12,759 BA view · diff
git:20261106.db9bb142026-11-06 db9bb14 12,687 BA view · diff
git:20261104.44046332026-11-04 4404633 12,577 BA view · diff
git:20261104.e27cb652026-11-04 e27cb65 12,422 BA view · diff
git:20261104.bf6bb9e2026-11-04 bf6bb9e 11,734 BA view · diff
git:20261012.fe370ec2026-10-12 fe370ec 10,249 BA view · diff
git:20261011.fb45e062026-10-11 fb45e06 8,953 BA view · diff
git:20261011.243278c2026-10-11 243278c 8,756 BA view · diff
git:20260914.dd89a872026-09-14 dd89a87 8,742 BA view · diff
git:20260912.860b3f02026-09-12 860b3f0 8,234 BA view · diff
git:20260911.8c60b8c2026-09-11 8c60b8c 7,837 BA view · diff
git:20260905.88afa552026-09-05 88afa55 7,990 BA view · diff
git:20260831.a4de54b2026-08-31 a4de54b 7,386 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 (12759 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

bretfisher/skills · 21 stars · license MIT · pushed 2026-11-07 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_g4gptqlj5ckzq7v3
GET https://markdownregistry.com/api/v1/resolve?ref=bretfisher/skills/AGENTS.md
GET https://markdownregistry.com/api/v1/blob/7e21baecf8bf2c9e470a688a08670c9b53177e8465bb5576503f6db3f4e6d28a

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 bretfisher/skills

skill-creator SKILL.md skill
bretfisher/skills · .agents/skills/skill-creator/SKILL.md · Create new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a…
git:20260608.879e4b9 · audit A · 21 stars
CLAUDE.md CLAUDE.md file
bretfisher/skills · CLAUDE.md
git:20260608.c4a648b · audit B · 21 stars
CLAUDE.md@evals/super-linting/fixtures/py-claude CLAUDE.md file
bretfisher/skills · evals/super-linting/fixtures/py-claude/CLAUDE.md
git:20261011.fb45e06 · audit B · 21 stars
docker-pro SKILL.md skill
bretfisher/skills · plugins/devops/skills/docker-pro/SKILL.md · Create, edit, and modernize Dockerfiles, .dockerignore, Docker Bake files, and Compose files using Bret Fisher's…
git:20261104.e27cb65 · audit A · 21 stars
gha-audit SKILL.md skill
bretfisher/skills · plugins/devops/skills/gha-audit/SKILL.md · Audit the GitHub Actions workflows in this repo for security, speed, and correctness, and report findings with a…
git:20261104.e27cb65 · audit A · 21 stars
github-actions-workflow-pro SKILL.md skill
bretfisher/skills · plugins/devops/skills/github-actions-workflow-pro/SKILL.md · Create, edit, audit, and speed up GitHub Actions workflows using Bret Fisher's opinionated DevOps rules. Use it when…
git:20261104.8a9119a · audit A · 21 stars
k8s-catch-up SKILL.md skill
bretfisher/skills · plugins/devops/skills/k8s-catch-up/SKILL.md · Kubernetes features that reached beta or GA in v1.35 to v1.37 (Dec 2025 to Aug 2026), newer than most models' training…
git:20261104.e27cb65 · audit A · 21 stars
k8s-podspec-pro SKILL.md skill
bretfisher/skills · plugins/devops/skills/k8s-podspec-pro/SKILL.md · Writes and reviews Kubernetes pod specs against Bret Fisher's production floor (github.com/BretFisher/podspec) for…
git:20261107.73c7ca5 · audit A · 21 stars
super-linting SKILL.md skill
bretfisher/skills · plugins/devops/skills/super-linting/SKILL.md · Set up local development linting by picking the right linters for each file type a project uses, then recording them as…
git:20261104.e27cb65 · audit A · 21 stars
screencapture-mac SKILL.md skill
bretfisher/skills · plugins/utils/skills/screencapture-mac/SKILL.md · Captures the user's macOS screen, a window, or a region with the built-in `screencapture` CLI, then reads the image so…
git:20261104.e27cb65 · audit A · 21 stars

Every file in bretfisher/skills

Other files named AGENTS.md

AGENTS.md AGENTS.md file
morluto/rea · AGENTS.md
git:20261102.920d634 · audit A · 433,876 stars
AGENTS.md AGENTS.md file
obra/superpowers · AGENTS.md
git:20261020.b739a8a · audit A · 314,583 stars
AGENTS.md AGENTS.md file
affaan-m/ecc · AGENTS.md
git:20261030.f29e332 · audit A · 299,696 stars
AGENTS.md AGENTS.md file
firecrawl/firecrawl · AGENTS.md
git:20261008.5a75dca · audit A · 199,595 stars
AGENTS.md AGENTS.md file
dietrichgebert/ponytail · AGENTS.md
git:20261008.2a1fe84 · audit A · 185,249 stars
AGENTS.md AGENTS.md file
graphify-labs/graphify · AGENTS.md
git:20260926.98d73fe · audit A · 144,492 stars
AGENTS.md AGENTS.md file
garrytan/gstack · AGENTS.md
git:20261107.ef99eb5 · audit A · 140,694 stars
AGENTS.md AGENTS.md file
juliusbrussee/caveman · AGENTS.md
git:20261106.e45976c · audit A · 118,366 stars

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