Ops-Claude Skill

Maintenance and diagnostics for Claude Code installations.

Supported IDEs/CLIs

| IDE | Skills Path | User-level | |-----|-------------|------------| | Claude Code | .claude/skills | ~/.claude/skills | | Pi Agent | .pi/skills | ~/.pi/skills | | Codex | .codex/skills | ~/.codex/skills | | KiloCode | .kilocode/skills | ~/.kilocode/skills | | GitHub Copilot | .github/skills | - | | Antigravity/Gemini | .gemini/skills | ~/.gemini/skills | | Agent (generic) | .agent/skills | ~/.agent/skills |

Common Issues Addressed

| Error | Cause | Fix Command | |-------|-------|-------------| | ENOSPC: System limit for number of file watchers | inotify exhaustion | ./run.sh fix-inotify | | JavaScript heap out of memory | Too many files in skills | ./run.sh clean-skills | | Allocation failed | Node.js heap limit | ./run.sh fix-heap | | Claude hangs on startup | Corrupted cache | ./run.sh clean-cache |

Commands

diagnose

Run full diagnostics and report issues.

./run.sh diagnose

fix-inotify

Increase inotify limits (requires sudo).

./run.sh fix-inotify

fix-heap

Set NODE_OPTIONS for larger heap.

./run.sh fix-heap

clean-skills

Remove .venv, pycache, .pytest_cache from all skills directories.

./run.sh clean-skills

clean-cache

Clear Claude Code's cache directories.

./run.sh clean-cache

status

Show current resource usage and limits.

./run.sh status

gitignore

Add/update .gitignore in all skills directories.

./run.sh gitignore

Quick Fixes

# Full diagnostic + automatic fixes
./run.sh diagnose --fix

# Just see status
./run.sh status

# Emergency cleanup (all caches)
./run.sh clean-all

Proactive Usage

Run ./run.sh diagnose when:

• Claude Code fails to start
• Claude Code crashes with memory errors
• After syncing skills across projects
• System feels sluggish with many projects open