Agent skill
ops-claude
Claude Code maintenance and diagnostics. Check inotify limits, clean caches, diagnose startup failures, and manage skills directories across projects.
Stars
163
Forks
31
Install this agent skill to your Project
npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/data/ops-claude
Metadata
Additional technical details for this skill
- short description
- Claude Code maintenance and diagnostics
SKILL.md
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.
bash
./run.sh diagnose
fix-inotify
Increase inotify limits (requires sudo).
bash
./run.sh fix-inotify
fix-heap
Set NODE_OPTIONS for larger heap.
bash
./run.sh fix-heap
clean-skills
Remove .venv, pycache, .pytest_cache from all skills directories.
bash
./run.sh clean-skills
clean-cache
Clear Claude Code's cache directories.
bash
./run.sh clean-cache
status
Show current resource usage and limits.
bash
./run.sh status
gitignore
Add/update .gitignore in all skills directories.
bash
./run.sh gitignore
Quick Fixes
bash
# 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
Didn't find tool you were looking for?