super-linting SKILL.md skillA

super-linting from bretfisher/skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add bretfisher/skills/super-linting@git:20261104.e27cb65

Pins git:20261104.e27cb65 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
bretfisher/skills
Path
plugins/devops/skills/super-linting/SKILL.md
Versions recorded
1
Latest version
git:20261104.e27cb65, committed Nov 4, 2026
Size
8,485 bytes
Repository stars
21
License
MIT

Set up local development linting by picking the right linters for each file type a project uses, then recording them as required pre-commit checks in AGENTS.md / CLAUDE.md and a `make lint` target. Uses the super-linter project as the live source of truth for which linters are current and popular per language. Use this skill whenever the user wants to add, choose, configure, or standardize linters for local development; asks "what linter should I use for X"; wants the agent to lint files…

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

# Super-Linting: local linters for every file type

Pick the right linter for each file type a project uses, then make those linters a required step before every commit — written as instructions the agent will follow in the project's agent guide, plus a `make lint` command a human can run.

## How linting gets enforced (default vs opt-in)

The **default** enforcement is soft and zero-install: a `## Linting` section in AGENTS.md/CLAUDE.md that tells the agent to lint before committing, backed by a `make lint` target. This is enough for most projects and adds no git machinery.

A git **pre-commit hook** is a stronger, harder gate (it blocks the actual `git commit`), but it's extra setup the user didn't necessarily ask for. So **do not add a git hook or a `pre-commit`-framework config by default.** After you've written the agent-guide contract, ask the user whether they want it:

> "I've set up linting as instructions in your agent guide + `make lint`. Want me to also add a real git pre-commit hook that blocks commits when a linter fails, or is relying on the agent (and `make lint`) enough for you?"
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add bretfisher/skills/super-linting@sha256:340b7816418b05be

The line at the top of this page pins the label git:20261104.e27cb65, 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_n62flduin2jwkhul.svg)](https://markdownregistry.com/a/art_n62flduin2jwkhul)

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

Versions

The registry has recorded 1 version of this file, committed on Nov 4, 2026.

versioncommittedcommitsizeaudit
git:20261104.e27cb65 latest2026-11-04 e27cb65 8,485 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 (8485 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_n62flduin2jwkhul
GET https://markdownregistry.com/api/v1/resolve?ref=bretfisher/skills/super-linting
GET https://markdownregistry.com/api/v1/blob/340b7816418b05be13aef8cf01fef3d356eb0658391c13ea131f9a11c5e8a862

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 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
AGENTS.md AGENTS.md file
bretfisher/skills · AGENTS.md
git:20261106.9ca18d3 · 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
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

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