janitor-fix SKILL.md skillA

janitor-fix from khendzel/skills-janitor is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add khendzel/skills-janitor/janitor-fix@v1.5.1

Pins v1.5.1 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
khendzel/skills-janitor
Path
skills/janitor-fix/SKILL.md
Versions recorded
5
Latest version
v1.5.1, committed Jul 11, 2026
First version recorded
Apr 15, 2026
Size
4,323 bytes
Repository stars
122
License
MIT

Automatically fix skill problems (safe preview first). Also use with --prune to find and remove broken symlinks, empty directories, and orphaned skills. Trigger with '/janitor-fix'.

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

# Auto-Fix

Automatically fix common skill issues. Dry-run by default — shows what would change without modifying files.

## Overview

Repairs frontmatter problems (missing delimiters, empty descriptions, missing version fields) across user, project, and codex-scope skills, and — in `--prune` mode — removes broken symlinks and empty skill directories. Plugin/marketplace skills are never modified (changes would be overwritten on update).

## Prerequisites

- Claude Code with the skills-janitor plugin installed (provides `scripts/fix.sh`)
- bash 3.2+ (the stock macOS bash works; no external dependencies)
- Write access to the user's own skill directories (`~/.claude/skills`, `./.claude/skills`, `~/.agents/skills`)

## Instructions

### Step 1: Preview first (always)

```bash
bash ~/.claude/skills/skills-janitor/scripts/fix.sh            # preview fixes
bash ~/.claude/skills/skills-janitor/scripts/fix.sh --prune    # preview broken/orphaned removals
```

### Step 2: Show the user the preview and confirm

Never jump straight to `--apply`. Present the `[DRY RUN]` lines and ask before writing.

### Step 3: Apply

```bash
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add khendzel/skills-janitor/janitor-fix@sha256:556f4dc63ed82ea6

The line at the top of this page pins the label v1.5.1, 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_lr5uyecybegmnu4x.svg)](https://markdownregistry.com/a/art_lr5uyecybegmnu4x)

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

Versions

The registry has recorded 5 versions of this file, between Apr 15, 2026 and Jul 11, 2026, about one every 22 days.

versioncommittedcommitsizeaudit
v1.5.1 latest2026-07-11 c63c347 4,323 BA view · diff
v1.5.02026-07-10 e9cb877 1,647 BA view · diff
v1.3.02026-05-22 89558a4 1,680 BA view · diff
v1.2.02026-04-29 8a790eb 1,680 BA view · diff
v1.1.02026-04-15 225b79f 1,680 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 (4323 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

khendzel/skills-janitor · 122 stars · license MIT · pushed 2026-09-30 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_lr5uyecybegmnu4x
GET https://markdownregistry.com/api/v1/resolve?ref=khendzel/skills-janitor/janitor-fix
GET https://markdownregistry.com/api/v1/blob/556f4dc63ed82ea650562e1046eb5bf7e89d5fa4128c124156cc54b50b264890

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 khendzel/skills-janitor

janitor-discover SKILL.md skill
khendzel/skills-janitor · skills/janitor-discover/SKILL.md · Find new skills on GitHub or check a specific skill before installing. Use when the user wants to search for skills…
v1.6.0 · audit A · 122 stars
janitor-report SKILL.md skill
khendzel/skills-janitor · skills/janitor-report/SKILL.md · Full health check of all your skills in one report. Use when the user wants to check for errors, find duplicates…
v1.7.0 · audit A · 122 stars
janitor-security SKILL.md skill
khendzel/skills-janitor · skills/janitor-security/SKILL.md · Heuristic security scan of installed skills — prompt-injection phrases, hidden unicode instructions, credential-store…
v1.6.0 · audit C · 122 stars
janitor-swipe SKILL.md skill
khendzel/skills-janitor · skills/janitor-swipe/SKILL.md · Tinder for your Claude Code skills. Reviews a sorted deck of every installed skill and lets you swipe keep / delete /…
v1.7.0 · audit A · 122 stars
janitor-value SKILL.md skill
khendzel/skills-janitor · skills/janitor-value/SKILL.md · Show whether each skill is earning its context-window cost — combined tokens-used view sorted by waste. Use when the…
v1.7.0 · audit A · 122 stars

Every file in khendzel/skills-janitor

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