# Janitor Check

> Check skills for errors and missing info

- Skill: `majiayu000/janitor-check` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add majiayu000/janitor-check`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/janitor-check/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/janitor-check

---


# Skill Check

Check all skills against best practices and quality standards.

## How to Run

```bash
bash ~/.claude/skills/skills-janitor/scripts/lint.sh
```

## Rules Checked

### Critical
- Broken symlinks
- Missing SKILL.md file
- Missing frontmatter delimiters (`---`)

### Warning
- Missing or empty `name` field
- Missing or empty `description` field
- Description too short (< 30 chars) or too long (> 200 chars)
- Description doesn't explain trigger conditions (missing "when"/"use when")
- Folder name doesn't match `name` field
- Missing `version` field

### Info
- No body content after frontmatter
- No Gotchas section
- Large files (>500 lines) without progressive disclosure

## Best Practices Reference

### Description Quality
- 50-200 characters
- Must explain WHEN to trigger, not just WHAT it does
- Include trigger keywords the user might say
- Format: "Use when [condition]. Also use when [user says X, Y, Z]."

### Frontmatter
- `name` - required, matches folder name
- `description` - required, model-facing trigger description
- `version` - recommended

## Related Skills

- For auto-fixing issues found: `/janitor-fix`
- For duplicate detection: `/janitor-duplicates`
- For full health report: `/janitor-report`