Agent skill

Janitor Fix

Automatically fix skill problems (safe preview first). An agent skill from khendzel/skills-janitor.

MITAuto-check passed

Install Janitor Fix

skills CLI

$ npx skills add khendzel/skills-janitor --skill janitor-fix -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI

$ gh skill install khendzel/skills-janitor janitor-fix --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy

$ git clone --depth 1 https://github.com/khendzel/skills-janitor.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/janitor-fix .claude/skills/janitor-fix && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Paste into Claude Code

Install the "janitor-fix" agent skill from https://github.com/khendzel/skills-janitor/tree/main/skills/janitor-fix into .claude/skills/janitor-fix/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "janitor-fix", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

$skill-installer

$skill-installer install https://github.com/khendzel/skills-janitor/tree/main/skills/janitor-fix

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add khendzel/skills-janitor --skill janitor-fix -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install khendzel/skills-janitor janitor-fix --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/khendzel/skills-janitor.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/janitor-fix .agents/skills/janitor-fix && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "janitor-fix" agent skill from https://github.com/khendzel/skills-janitor/tree/main/skills/janitor-fix into .agents/skills/janitor-fix/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "janitor-fix", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add khendzel/skills-janitor --skill janitor-fix -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install khendzel/skills-janitor janitor-fix --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/khendzel/skills-janitor.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/janitor-fix .cursor/skills/janitor-fix && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "janitor-fix" agent skill from https://github.com/khendzel/skills-janitor/tree/main/skills/janitor-fix into .cursor/skills/janitor-fix/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "janitor-fix", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

gemini skills install

$ gemini skills install https://github.com/khendzel/skills-janitor.git --path skills/janitor-fix

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add khendzel/skills-janitor --skill janitor-fix -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install khendzel/skills-janitor janitor-fix --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/khendzel/skills-janitor.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/janitor-fix .gemini/skills/janitor-fix && rm -rf skills-src

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "janitor-fix" agent skill from https://github.com/khendzel/skills-janitor/tree/main/skills/janitor-fix into .gemini/skills/janitor-fix/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "janitor-fix", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install khendzel/skills-janitor janitor-fix

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add khendzel/skills-janitor --skill janitor-fix -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/khendzel/skills-janitor.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/janitor-fix .github/skills/janitor-fix && rm -rf skills-src

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "janitor-fix" agent skill from https://github.com/khendzel/skills-janitor/tree/main/skills/janitor-fix into .github/skills/janitor-fix/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "janitor-fix", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add khendzel/skills-janitor --skill janitor-fix -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install khendzel/skills-janitor janitor-fix --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/khendzel/skills-janitor.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/janitor-fix .opencode/skills/janitor-fix && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "janitor-fix" agent skill from https://github.com/khendzel/skills-janitor/tree/main/skills/janitor-fix into .opencode/skills/janitor-fix/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "janitor-fix", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: janitor-fix
GitHub stars: 123
Used in: 1 other repo
Token cost: ~1.1k tokens
SKILL.md length: 442 words
Files: 1
Skills in repo: 5
Repo updated: Sep 30, 2026
First seen: Oct 7, 2026
Licence: MIT

At a glance

Automatically fix skill problems (safe preview first). An agent skill from khendzel/skills-janitor.

Works in 3 steps: Preview first (always) → Show the user the preview and confirm → Apply
With /janitor-fix
SKILL.md covers Overview, Prerequisites, Instructions and Output, plus 3 more sections
Calls bash

What it does

Janitor Fix is an agent skill from khendzel/skills-janitor. 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'.

Its SKILL.md is about 1.1k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts. Compatibility notes: Designed for Claude Code. Requires bash 3.2+ (macOS default works). Modifies only user/project/codex-scope skill files, never plugin content.

The repository describes itself as: Tinder for your Claude Code skills, subagents and MCP servers. Swipe away what wastes context, scan for prompt injection, get honest token costs. Fixes what it finds and actually… The licence is MIT.

When your agent uses it

With /janitor-fix

Example prompts

“/janitor-fix”
“/janitor-fix”

Requirements

Compatibility (from SKILL.md): Designed for Claude Code. Requires bash 3.2+ (macOS default works). Modifies only user/project/codex-scope skill files, never plugin content.
Pre-approved tools (allowed-tools): Read, Bash(bash:*)

Workflow steps

3 steps, taken from the step headings in SKILL.md.

Preview first (always)
Show the user the preview and confirm
Apply

What it can do on your machine

Read from SKILL.md and the folder at commit 4b42f39. It shows what the files ask for, not the result of running them.

Tool permissions
Pre-approves these tools, so the agent can use them without asking each time:
- Read
- Bash(bash:*)
From allowed-tools in the SKILL.md frontmatter.
Runs code
Shell commands in SKILL.md call:
- bash
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Compatibility
Designed for Claude Code. Requires bash 3.2+ (macOS default works). Modifies only user/project/codex-scope skill files, never plugin content.
From compatibility in the SKILL.md frontmatter.

Context cost

Janitor Fix loads about 1.1k tokens when it runs. Until then it costs about 48 tokens; SKILL.md has 442 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it: ~48
When it runs · the whole SKILL.md, loaded when a task matches: ~1.1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from khendzel/skills-janitor at commit 4b42f39, republished under its MIT licence (© khendzel). 442 words, ~1,077 tokens.

Download SKILL.mdSave it as .claude/skills/janitor-fix/SKILL.md (or your agent's skills folder).

name: janitor-fix
description: 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'.
allowed-tools: Read, Bash(bash:*)
compatibility: Designed for Claude Code. Requires bash 3.2+ (macOS default works). Modifies only user/project/codex-scope skill files, never plugin content.
argument-hint: [--apply] [--prune]
version: 1.5.1
author: Krzysztof Hendzel <krzysztoff.hendzel@gmail.com>
license: MIT
tags: skills, auto-fix, cleanup, symlinks, maintenance

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

bash ~/.claude/skills/skills-janitor/scripts/fix.sh --apply           # apply fixes
bash ~/.claude/skills/skills-janitor/scripts/fix.sh --prune --apply   # remove broken skills

What it fixes:

Adds missing frontmatter delimiters (---)
Fills empty description fields with a template
Adds missing version field (defaults to "1.0.0")
Generates template descriptions using the skill folder name

Prune mode finds and removes:

Broken symlinks — skill folder points to deleted source
Empty directories — skill folder with no SKILL.md
Orphaned skills — user-scope copies of plugin skills

Safety model: dry-run by default (must pass --apply to write), skips plugin/marketplace skills, logs ALL changes with timestamps to data/changelog.log, always asks for confirmation before removing.

Output

Per-skill action lines ([DRY RUN] / [FIXED] / [PRUNED] / [SKIP]) followed by a summary of fixable issues, skipped items, and prunable entries. In dry-run mode the summary ends with "Run with --apply to make these changes."

Show full SKILL.md (207 more words)Show less

Error Handling

Error: A fix produced an unexpected result in a SKILL.md Solution: Every applied change is logged in data/changelog.log with a timestamp — show the log entry and restore the affected field manually; template descriptions are meant to be replaced by the author.
Error: [SKIP] Plugin/marketplace skill - don't modify Solution: Expected behavior, not an error. Plugin content is fixed upstream — suggest the user report the issue to the plugin author instead.
Error: Prune lists a skill the user wants to keep Solution: Do not run --apply. A "broken symlink" that should be kept means its target moved — recreate the link (ln -sfn <new-target> <link>) instead of pruning.

Examples

Example 1: Safe fix cycle

Input: "Fix my skills."

Output: Run the dry-run, present the [DRY RUN] list ("3 fixable: 2 missing descriptions, 1 missing version"), ask for confirmation, then run --apply and report the [FIXED] lines.

Example 2: Cleanup of broken leftovers

Input: "Remove broken skills."

Output: Run --prune (dry-run), show what would be removed and why (broken symlink targets, empty dirs), confirm, then --prune --apply and report the [PRUNED] lines.

Resources

Fix script (plugin-relative): {baseDir}/../../scripts/fix.sh
Change log of applied fixes: data/changelog.log in the plugin directory
For finding issues: /janitor-report
For usage + token cost: /janitor-value

Files

Just SKILL.md in skills/janitor-fix of khendzel/skills-janitor.

Open the folder on GitHubat commit 4b42f39

Used in 1 other repository

We found 1 copy of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in khendzel/skills-janitor, which our catalogue first saw on October 7, 2026.

jeremylongshore/tons-of-skills-marketplaceplugins/community/skills-janitor/skills/janitor-fix

Compare with similar skills

Janitor Fix next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Janitor Fix compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Janitor Fix this skillkhendzel/skills-janitor	123	1 repos	~1.1k	Automated safety check: Pass	MIT	8 days ago
Is This A Problemanthropics/claude-for-legal	9.6k	2 repos	~2.3k	Automated safety check: Pass	Apache-2.0	8 days ago
Langfuse Previewslangfuse/langfuse	36k	—	~2.8k	Automated safety check: Notes	Custom licence	today
Upload Element Previewsremotion-dev/remotion	62k	—	~265	Automated safety check: Pass	Custom licence	today
Windmill Dev Page Previewwindmill-labs/windmill	18k	—	~1.8k	Automated safety check: Pass	Custom licence	today
Safe PushJetBrains/intellij-community	21k	—	~1.1k	Automated safety check: Pass	Custom licence	today

Similar skills

Is This A Problem
anthropics/claude-for-legal
Official
Fast "is this a problem?" answer for the quick Slack question — pattern-matches against your calibration.
9.6k GitHub starsUsed in 2 repos~2.3k tokens
Business, Finance & HRAuto-check passed
Langfuse Previews
langfuse/langfuse
Use Langfuse's disposable per-PR previews at pr-N.preview.langfuse.com (synthetic data only).
36k GitHub stars~2.8k tokensUpdated today
AI & LLM EngineeringAuto-check: notes
Upload Element Previews
remotion-dev/remotion
Official
Upload a Remotion Element's preview assets to remotion.media and replace local preview URLs.
62k GitHub stars~265 tokensUpdated today
Media & CreativeAuto-check passed
Windmill Dev Page Preview
windmill-labs/windmill
Opens the Windmill dev page to preview a flow, script or app, choosing between proxy and direct mode and deciding whether the agent or the runtime starts the wmill dev server.
18k GitHub stars~1.8k tokensUpdated today
DevelopmentAuto-check passed
Safe Push
JetBrains/intellij-community
Official
Push IntelliJ repository changes through the Safe Push workflow.
21k GitHub stars~1.1k tokensUpdated today
Auto-check passed
Safe Refactor
JuliusBrussee/caveman
Restructure code while preserving behavior. Use for extraction, consolidation, ownership moves, or cleanup where verification must bracket structural edits.
110k GitHub starsUsed in 1 repo~177 tokens
DevelopmentAuto-check passed

Questions about Janitor Fix

What does Janitor Fix do?

Automatically fix skill problems (safe preview first). An agent skill from khendzel/skills-janitor. Janitor Fix is an agent skill from khendzel/skills-janitor. Automatically fix skill problems (safe preview first).

When should I use Janitor Fix?

Janitor Fix fits situations like: with /janitor-fix.

How do I install Janitor Fix in Claude Code?

Run `npx skills add khendzel/skills-janitor --skill janitor-fix -a claude-code`. Or copy the skill folder (skills/janitor-fix in khendzel/skills-janitor) into .claude/skills/janitor-fix in your project. Claude Code loads it when a task matches its description.

How do I install Janitor Fix in Codex?

Run `npx skills add khendzel/skills-janitor --skill janitor-fix -a codex`. Or copy the skill folder (skills/janitor-fix in khendzel/skills-janitor) into .agents/skills/janitor-fix in your project. Codex loads it when a task matches its description.

Can I use Janitor Fix in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add khendzel/skills-janitor --skill janitor-fix -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/janitor-fix, .gemini/skills/janitor-fix, .github/skills/janitor-fix and .opencode/skills/janitor-fix in your project.

What does Janitor Fix need to run?

Going by SKILL.md and its folder, Janitor Fix needs the command-line tools its instructions call (bash). Its frontmatter pre-approves these tools: Read, Bash(bash:*). Compatibility (from SKILL.md): Designed for Claude Code. Requires bash 3.2+ (macOS default works). Modifies only user/project/codex-scope skill files, never plugin content..

Does Janitor Fix access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Janitor Fix safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Janitor Fix use?

Janitor Fix is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Janitor Fix use?

About 1.1k tokens (SKILL.md is roughly 4.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Janitor Fix?

Skills that share tags, products or a category with Janitor Fix: Is This A Problem (anthropics/claude-for-legal, 9.6k stars), Langfuse Previews (langfuse/langfuse, 36k stars), Upload Element Previews (remotion-dev/remotion, 62k stars) and Windmill Dev Page Preview (windmill-labs/windmill, 18k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Janitor Fix?

khendzel (a GitHub user) maintains it in khendzel/skills-janitor, which has 123 GitHub stars. The repository holds 5 skills in this directory. The repository was last updated on September 30, 2026.

Source: khendzel/skills-janitor on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.

Install Janitor Fix

Facts

At a glance

What it does

When your agent uses it

Example prompts

Requirements

Workflow steps

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Compatibility

Context cost

Safety

SKILL.md

Auto-Fix

Overview

Prerequisites

Instructions

Step 1: Preview first (always)

Step 2: Show the user the preview and confirm

Step 3: Apply

Output

Error Handling

Examples

Example 1: Safe fix cycle

Example 2: Cleanup of broken leftovers

Resources

Files

Used in 1 other repository

Compare with similar skills

Similar skills

More from khendzel/skills-janitor

Questions about Janitor Fix