AugmentClaude
Personal Productivity

Janitor Swipe

By khendzel· khendzel/skills-janitor· 0

Swipe through your Claude skills to keep, delete, or skip each one interactively.

Installation

  1. Make sure Claude is on your device and in your terminal.

    Skills load from ~/.claude/skills/ when Claude Code starts up — so you need it on your machine first. If you don't have it yet, install it once with the command below, then run claude in any terminal to verify.

    One-time setup
    npm i -g @anthropic-ai/claude-code

    Already have it? Skip ahead.

  2. Paste into Claude Code or into your terminal.
    Install
    Sign up to copy
    Sign up free to reveal

    This copies the whole skill folder into ~/.claude/skills/janitor-swipe-khendzel/ — the SKILL.md plus any scripts, reference docs, or templates the skill ships with. Safe default: works for every skill.

    Faster alternative (instruction-only skills)

    Skips the clone and grabs only the SKILL.md file. Don't use this if the skill ships Python scripts, reference markdowns, or asset templates — they won't be downloaded and the skill will fail when it tries to load them.

    Quick install (SKILL.md only)
    Sign up to copy
    Sign up free to reveal
  3. Restart Claude Code.

    Quit and reopen Claude Code (or any other agent that loads from ~/.claude/skills/). New skills are picked up on startup.

  4. Just ask Claude.

    Skills auto-activate when your request matches the skill's description — no slash command needed. Trigger phrases live in the skill's own frontmatter; you can read them in the “What this skill does” section above.

Prefer to read the source first? Open on GitHub.

When Claude uses it

Tinder for your Claude Code skills. Reviews a sorted deck of every installed skill and lets you swipe keep / delete / skip on each one. Use when the user wants to bulk-clean their skill collection, triage unused skills, or do interactive skill cleanup.

What this skill does

Janitor Swipe — interactive skill triage

A bash TUI that puts every installed skill into a sorted deck and lets the user swipe keep / delete / skip on each card. The deck is sorted "most likely waste first" — heavy, never-used skills appear at the top, so most users hit ← delete a few times and quit before reviewing the whole list.

How to Run

Important: the swipe TUI needs an interactive terminal. Inside Claude Code, the Bash tool's stdin is non-interactive, so the keypress reader can't work. The user must invoke it via the ! prefix so the command runs in their actual shell:

!bash ~/.claude/skills/skills-janitor/scripts/swipe.sh

When the user asks for /janitor-swipe, tell them to run that command in their terminal. Do NOT try to run it yourself via the Bash tool — it will error with "needs an interactive terminal".

What the User Sees

Each card shows:

  • Skill name + position in deck (e.g. [3 / 47])
  • Context cost split: X always · Y on trigger (description tokens are permanent; body loads only when the skill fires)
  • Usage count and last invoked date
  • Scope (user, project, plugin · <plugin-name>, etc.)
  • 3-line truncated description
  • Verdict label (e.g. "Heavy + unused — likely dead weight")

Controls:

  • ← / h / d — stage for delete
  • → / l / k — keep
  • ↓ / j / s / space — skip
  • u — undo (back up one card, clear its decision)
  • i — inspect (show full SKILL.md description)
  • q / Esc — quit (still shows summary for decisions made so far)

Scope-Aware Behavior

This is the critical correctness point — the swipe doesn't lie about what it can delete:

ScopeWhat happens on swipe left
user, project, codex-user, codex-projectPath is staged for rm -rf (or unlink if symlink)
plugin, plugin-sourceNOT deleted — flagged under "Plugins to review" at the apply screen, with a hint to run /plugin uninstall <plugin> if enough skills from that plugin were swiped

Apply Screen

After the last card (or q), the user sees a summary and is prompted:

  • y — apply deletions immediately
  • N — cancel
  • save — write decisions to ~/.skills-janitor/swipe-<timestamp>.json for later application via swipe.sh --apply <file>

Every deletion is logged to ~/.skills-janitor/log.jsonl with the path and frontmatter snapshot.

Edge Cases

  • No skills installed → exits 0 with a message
  • Terminal < 50 cols or < 22 rows → exits 1 with a message
  • No TTY → exits 1 with a message pointing the user at /janitor-report or /janitor-value for list-form output
  • Symlinks → rm the link itself, never follow to the target

Related Skills

  • /janitor-report — same data as a non-interactive list
  • /janitor-value — combined token + usage view (the data underneath the swipe deck)
  • /janitor-fix --prune — automated broken-symlink cleanup, no interactive review

Related skills

W

Word Document Editor

anthropics

Create, edit, and format Word documents with tables, images, and tracked changes.

OfficialProprietary. LICENSE.txt has complete terms
S

Skill Template

anthropics

A template for creating and configuring new Claude skills.

Official
K

Kanban TUI

Zaloog

Manage tasks, boards, and workflows in your terminal with a CLI kanban tool.

S

Superpowers

obra

Jesse Vincent's full Claude Code methodology — TDD, brainstorming, git worktrees, all auto-triggering.

MIT