catalog-audit SKILL.md skillA

catalog-audit from stacklok/toolhive-catalog is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add stacklok/toolhive-catalog/catalog-audit@git:20260627.8872a7a

Pins git:20260627.8872a7a in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
stacklok/toolhive-catalog
Path
.claude/skills/catalog-audit/SKILL.md
Versions recorded
1
Latest version
git:20260627.8872a7a, committed Jun 27, 2026
Size
9,124 bytes
Repository stars
23
License
Apache-2.0

Audit existing ToolHive catalog server entries for drift: whether the pinned image still exists, the upstream repo is still alive and active, and the declared env vars and network-permission profile still match what the server actually needs. Use whenever asked to audit, health-check, sweep, or spot-check catalog entries / server.json files for staleness, broken images, dead repos, abandoned projects, or wrong env-vars/permissions - for the community tier, the official tier, the whole…

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

# Catalog audit

Audit catalog entries that are **already in the registry** for three kinds of drift:

1. **Still valid** - the pinned OCI image still resolves; `repository.url` still loads.
2. **Still active** - the upstream repo isn't archived/disabled and isn't stale.
3. **Still canonically correct** - declared env vars and the network-permission
   profile match what the upstream project actually documents and requires.

This is **report-only**. Produce findings for a human to triage; never edit a
`server.json`, open a PR, or change permissions. The output is a dated markdown
report under `audits/`.

Checks 1 and 2 are mechanical and run via the bundled script. Check 3 needs
judgment over upstream docs and is done by fanning out sub-agents. Grading rules
and severity live in [references/audit-criteria.md](references/audit-criteria.md) -
read it before writing findings.

## Step 1 - resolve scope

Infer scope from the request, don't ask for rigid flags. Map intent to a server set:

- "the community servers" / "community tier" -> `--tier community`
- "official servers" -> `--tier official`
- "the whole catalog" / "everything" -> `--tier all`
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add stacklok/toolhive-catalog/catalog-audit@sha256:0bbf9fb977866b00

The line at the top of this page pins the label git:20260627.8872a7a, 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_gods3hzcljx7siuj.svg)](https://markdownregistry.com/a/art_gods3hzcljx7siuj)

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

Versions

The registry has recorded 1 version of this file, committed on Jun 27, 2026.

versioncommittedcommitsizeaudit
git:20260627.8872a7a latest2026-06-27 8872a7a 9,124 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 (9124 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

stacklok/toolhive-catalog · 23 stars · license Apache-2.0 · pushed 2026-10-19 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_gods3hzcljx7siuj
GET https://markdownregistry.com/api/v1/resolve?ref=stacklok/toolhive-catalog/catalog-audit
GET https://markdownregistry.com/api/v1/blob/0bbf9fb977866b0095a4a7501186279914c811fffa8f733fa3931677192c8996

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 stacklok/toolhive-catalog

add-mcp-server SKILL.md skill
stacklok/toolhive-catalog · .claude/skills/add-mcp-server/SKILL.md · Add new MCP server entries to the ToolHive registry. Creates server.json and icon.svg files with correct schema, _meta…
git:20260630.d62bac1 · audit A · 23 stars
mcp-review SKILL.md skill
stacklok/toolhive-catalog · .claude/skills/mcp-review/SKILL.md · Review MCP server specifications and updates for compliance, security, and quality. Use when evaluating server.json…
git:20260630.d62bac1 · audit A · 23 stars
skill-review SKILL.md skill
stacklok/toolhive-catalog · .claude/skills/skill-review/SKILL.md · Review skill submissions and updates for compliance, security, and quality. Use when evaluating skill.json files…
git:20260603.8ac39de · audit A · 23 stars
CLAUDE.md CLAUDE.md file
stacklok/toolhive-catalog · CLAUDE.md
git:20260415.a3ea4ca · audit A · 23 stars
ci-agent-hardening SKILL.md skill
stacklok/toolhive-catalog · registries/toolhive/skills/ci-agent-hardening/skill/SKILL.md · Audit and harden GitHub Actions workflows against prompt injection, pull_request_target exploits (Pwn Requests)…
v0.1.0 · audit A · 23 stars
code-review SKILL.md skill
stacklok/toolhive-catalog · registries/toolhive/skills/code-review/skill/SKILL.md · Reviews pull requests by analyzing code changes, checking for common issues, and providing structured feedback with…
v0.1.0 · audit A · 23 stars
skill-creator SKILL.md skill
stacklok/toolhive-catalog · registries/toolhive/skills/skill-creator/skill/SKILL.md · Guide for creating effective skills. Use when users want to create a new skill, update an existing skill, build a slash…
v0.1.0 · audit A · 23 stars

Every file in stacklok/toolhive-catalog

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