context-health
Use when validating or diagnosing the claude-ctx environment (consistency, duplicates, redundancy, optimization) - provides a diagnostic workflow and reporting structure for context health checks.
When & Why to Use This Skill
The Context Health skill is a specialized diagnostic utility designed to optimize and maintain the integrity of the claude-ctx environment. It provides a structured workflow to identify configuration inconsistencies, eliminate redundant data, and detect duplicate entries, ensuring that the AI agent operates with a clean, efficient, and high-performance context.
Use Cases
- System Integrity Audits: Perform comprehensive health checks after updating agent modes, rules, or configurations to ensure no breaking changes or inconsistencies were introduced.
- Performance Optimization: Identify and surface redundant or duplicate context information to reduce token waste and prevent degraded model reasoning caused by context bloat.
- Troubleshooting Agent Behavior: Diagnose unexpected AI responses or environment errors by generating detailed diagnostic reports with severity levels and actionable fix recommendations.
- Periodic Maintenance: Conduct routine environment 'check-ups' to verify config integrity and maintain a healthy long-term state for complex agentic workflows.
| name | context-health |
|---|---|
| description | Use when validating or diagnosing the claude-ctx environment (consistency, duplicates, redundancy, optimization) - provides a diagnostic workflow and reporting structure for context health checks. |
Context Health
Overview
Provide a consistent diagnostic workflow for claude-ctx environments: verify config integrity, detect duplicates, surface redundancies, and report actionable issues.
When to Use
- Checking system health after changes to agents, modes, or rules
- Troubleshooting unexpected claude-ctx behavior
- Performing periodic maintenance checks
Avoid when:
- The task is unrelated to claude-ctx configuration or context
Quick Reference
| Task | Load reference |
|---|---|
| Environment diagnostics | skills/context-health/references/doctor.md |
Workflow
- Confirm target scope and environment.
- Load the diagnostics reference.
- Run checks and gather findings.
- Summarize issues by severity.
- Recommend fixes and next steps.
Output
- Diagnostic report with severity levels
- Recommended fixes or follow-up actions
Common Mistakes
- Running fixes without reviewing findings
- Skipping context scope verification