Agent skill
ops-claude
Claude Code maintenance and diagnostics. Check inotify limits, clean caches, diagnose startup failures, and manage skills directories across projects.
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.
./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
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
majiayu000/claude-skill-registry
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
majiayu000/claude-skill-registry
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
majiayu000/claude-skill-registry
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
majiayu000/claude-skill-registry
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
majiayu000/claude-skill-registry
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
majiayu000/claude-skill-registry
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
Didn't find tool you were looking for?