Back to Details

janitor-fix

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Auto-Fix

自动修复

Automatically fix common skill issues. Dry-run by default - shows what would change without modifying files.
自动修复常见的Skill问题。默认执行试运行模式——仅显示将会做出的更改，不会修改文件。

How to Run

运行方式

bash
bash ~/.claude/skills/skills-janitor/scripts/fix.sh            # preview fixes
bash ~/.claude/skills/skills-janitor/scripts/fix.sh --apply     # apply fixes
bash ~/.claude/skills/skills-janitor/scripts/fix.sh --prune     # find broken/orphaned skills
bash ~/.claude/skills/skills-janitor/scripts/fix.sh --prune --apply  # remove broken skills
bash
bash ~/.claude/skills/skills-janitor/scripts/fix.sh            # 预览修复内容
bash ~/.claude/skills/skills-janitor/scripts/fix.sh --apply     # 应用修复
bash ~/.claude/skills/skills-janitor/scripts/fix.sh --prune     # 查找损坏/孤立的Skill
bash ~/.claude/skills/skills-janitor/scripts/fix.sh --prune --apply  # 移除损坏的Skill

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
  • 添加缺失的前置分隔符（
    ---
    ）
  • 用模板填充空的
    description
    字段
  • 添加缺失的
    version
    字段（默认值为"1.0.0"）
  • 利用Skill文件夹名称生成模板描述

Prune Mode (
--prune
)

清理模式（
--prune
）

Finds and removes broken skills:
  • Broken symlinks - skill folder points to deleted source
  • Empty directories - skill folder with no SKILL.md
  • Orphaned skills - user-scope copies of plugin skills
Dry-run by default. Pass 
--apply
to actually remove them.
查找并移除损坏的Skill：
  • 损坏的符号链接 - Skill文件夹指向已删除的源文件
  • 空目录 - 没有SKILL.md的Skill文件夹
  • 孤立的Skill - 插件Skill的用户范围副本
默认执行试运行模式。需传入
--apply
参数才能实际移除它们。

Safety

安全性

  • Dry-run by default - must pass 
    --apply
    to write changes
  • Skips plugin/marketplace skills (changes get overwritten on update)
  • Skips broken symlinks (unless 
    --prune
    mode)
  • Logs ALL changes with timestamps to 
    data/changelog.log
  • Always asks for confirmation before removing
  • 默认试运行模式 - 必须传入
    --apply
    参数才会写入更改
  • 跳过插件/市场Skill（更新时更改会被覆盖）
  • 跳过损坏的符号链接（除非处于
    --prune
    模式）
  • 将所有更改及时间戳记录到
    data/changelog.log
  • 移除前始终会请求确认

Related Skills

相关Skill

  • For finding issues: 
    /janitor-report
  • For usage analytics: 
    /janitor-usage
  • For token cost: 
    /janitor-tokens
  • 用于查找问题：
    /janitor-report
  • 用于使用分析：
    /janitor-usage
  • 用于令牌成本：
    /janitor-tokens